Settings API - Manual insertion schema table

  • Published Aug 04, 2025

Manual insertion (builtin:rum.web.manual-insertion)

Manually insert one of the snippet formats below into the pages of your application. Learn more about the different snippet formats. All formats are also available via the API, allowing you to automate their insertion as part of your build process.

Schema IDSchema groupsScope
builtin:rum.web.manual-insertion
  • group:rum-injection
APPLICATION - Web application
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:rum.web.manual-insertion
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:rum.web.manual-insertion
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:rum.web.manual-insertion

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

PropertyTypeDescriptionRequired
Javascript tag
javascriptTag		javascriptTag

JavaScript tag references an external file containing monitoring code and configuration. Due to its dynamic update mechanism, it is recommended for most use cases.

required
OneAgent JavaScript Tag
oneagentJavascriptTag		oneagentJavascriptTag

OneAgent JavaScript tag includes configuration and a reference to an external file containing the monitoring code. It needs to be updated after configuration changes and monitoring code updates.

required
OneAgent JavaScript Tag with SRI
oneagentJavascriptTagSRI		oneagentJavascriptTagSRI

OneAgent JavaScript tag with SRI includes configuration, a reference to an external file containing the monitoring code, and a hash that allows the browser to verify the integrity of the monitoring code before executing it. It needs to be updated after configuration changes and monitoring code updates.

required
Code Snippet
codeSnippet		codeSnippet

Code snippet is a piece of inline code that implements basic functionality and loads the full functionality either synchronously or deferred. Even though it implements an update mechanism, regular updates are still required to guarantee compatibility.

required
The javascriptTag object
PropertyTypeDescriptionRequired
Cache monitoring code and configuration for
cacheDuration		enum
  • 1
  • 3
  • 6
  • 12
  • 24
  • 72
  • 144
required
Script execution attribute
scriptExecutionAttribute		enum

Add the async attribute to download the monitoring code in parallel with parsing the page, and execute it immediately upon availability.

Add the defer attribute to execute the monitoring code after the page has finished parsing.

  • async
  • defer
  • none
optional
Add crossorigin=anonymous attribute
crossoriginAnonymous		boolean

Add the crossorigin=anonymous attribute to capture JavaScript error messages and W3C resource timings

required
The oneagentJavascriptTag object
PropertyTypeDescriptionRequired
Script execution attribute
scriptExecutionAttribute		enum

Add the async attribute to download the monitoring code in parallel with parsing the page, and execute it immediately upon availability

Add the defer attribute to execute the monitoring code after the page has finished parsing

  • async
  • defer
  • none
optional
The oneagentJavascriptTagSRI object
PropertyTypeDescriptionRequired
Script execution attribute
scriptExecutionAttribute		enum

Add the async attribute to download the monitoring code in parallel with parsing the page, and execute it immediately upon availability

Add the defer attribute to execute the monitoring code after the page has finished parsing

  • async
  • defer
  • none
optional
The codeSnippet object
PropertyTypeDescriptionRequired
Load the monitoring code
codeSnippetType		enum
  • SYNCHRONOUSLY
  • DEFERRED
required