Web application configuration API - PUT a web application

Updates the specified web application.

This API only supports web applications (including agentless applications and browser extensions). For mobile apps and custom applications, see Mobile and custom app API.

The request consumes and produces an application/json payload.

PUT	ManagedDynatrace for Government	`https://{your-domain}/e/{your-environment-id}/api/config/v1/applications/web/{id}`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/config/v1/applications/web/{id}`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/applications/web/{id}`

Authentication

To execute this request, you need an access token with WriteConfig scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter	Type	Description	In	Required
id	string	The ID of the web application to update. If you set the ID in the body as well, it must match this ID.	path	required
body	WebApplicationConfig	JSON body of the request, containing updated configuration of the web application.	body	optional

Parameter

Type

Description

Required

string

The ID of the web application to update.

If you set the ID in the body as well, it must match this ID.

path

required

body

WebApplicationConfig

JSON body of the request, containing updated configuration of the web application.

body

optional

Request body objects

The `WebApplicationConfig` object

Configuration of a web application.

Element	Type	Description	Required
metadata	ConfigurationMetadata	Metadata useful for debugging	optional
identifier	string	Dynatrace entity ID of the web application.	optional
name	string	The name of the web application, displayed in the UI.	required
type	string	The type of the web application. The element can hold these values `AUTO_INJECTED` `BROWSER_EXTENSION_INJECTED` `MANUALLY_INJECTED`	optional
realUserMonitoringEnabled	boolean	Real user monitoring enabled/disabled.	required
costControlUserSessionPercentage	number	Analize X% of user sessions.	required
loadActionKeyPerformanceMetric	string	The key performance metric of load actions. The element can hold these values `ACTION_DURATION` `CUMULATIVE_LAYOUT_SHIFT` `DOM_INTERACTIVE` `FIRST_INPUT_DELAY` `LARGEST_CONTENTFUL_PAINT` `LOAD_EVENT_END` `LOAD_EVENT_START` `RESPONSE_END` `RESPONSE_START` `SPEED_INDEX` `VISUALLY_COMPLETE`	required
sessionReplayConfig	SessionReplaySetting	Session replay settings	optional
xhrActionKeyPerformanceMetric	string	The key performance metric of XHR actions. The element can hold these values `ACTION_DURATION` `RESPONSE_END` `RESPONSE_START` `VISUALLY_COMPLETE`	required
loadActionApdexSettings	Apdex	Defines the Apdex settings of an application.	required
xhrActionApdexSettings	Apdex	Defines the Apdex settings of an application.	required
customActionApdexSettings	Apdex	Defines the Apdex settings of an application.	required
waterfallSettings	WaterfallSettings	These settings influence the monitoring data you receive for 3rd party, CDN, and 1st party resources.	required
monitoringSettings	MonitoringSettings	Real user monitoring settings.	required
userTags	UserTag[]	User tags settings.	optional
userActionAndSessionProperties	UserActionAndSessionProperties[]	User action and session properties settings. Empty List means no change	optional
userActionNamingSettings	UserActionNamingSettings	The settings of user action naming.	optional
metaDataCaptureSettings	MetaDataCapturing[]	Java script agent meta data capture settings.	optional
conversionGoals	ConversionGoal[]	A list of conversion goals of the application.	optional
urlInjectionPattern	string	Url injection pattern for manual web application.	optional

The `ConfigurationMetadata` object

Metadata useful for debugging

Element	Type	Description	Required
configurationVersions	integer[]	A sorted list of the version numbers of the configuration.	optional
currentConfigurationVersions	string[]	A sorted list of version numbers of the configuration.	optional
clusterVersion	string	Dynatrace version.	optional

The `SessionReplaySetting` object

Session replay settings

Element	Type	Description	Required
enabled	boolean	SessionReplay Enabled.	required
costControlPercentage	integer	Session replay sampling rating in percentage.	required
enableCssResourceCapturing	boolean	Capture (`true`) or don't capture (`false`) CSS resources from the session.	optional
cssResourceCapturingExclusionRules	string[]	A list of URLs to be excluded from CSS resource capturing.	optional

The `Apdex` object

Defines the Apdex settings of an application.

Element	Type	Description	Required
toleratedThreshold	number	Maximal value of apdex, which is considered as satisfied user experience.	optional
frustratingThreshold	number	Maximal value of apdex, which is considered as tolerable user experience.	optional
toleratedFallbackThreshold	number	Fallback threshold of an XHR action, defining a satisfied user experience, when the configured KPM is not available.	optional
frustratingFallbackThreshold	number	Fallback threshold of an XHR action, defining a tolerable user experience, when the configured KPM is not available.	optional

The `WaterfallSettings` object

These settings influence the monitoring data you receive for 3rd party, CDN, and 1st party resources.

Element	Type	Description	Required
uncompressedResourcesThreshold	integer	Warn about uncompressed resources larger than X bytes.	required
resourcesThreshold	integer	Warn about resources larger than X bytes.	required
resourceBrowserCachingThreshold	integer	Warn about resources with a lower browser cache rate above X%.	required
slowFirstPartyResourcesThreshold	integer	Warn about slow 1st party resources with a response time above X ms.	required
slowThirdPartyResourcesThreshold	integer	Warn about slow 3rd party resources with a response time above X ms.	required
slowCdnResourcesThreshold	integer	Warn about slow CDN resources with a response time above X ms.	required
speedIndexVisuallyCompleteRatioThreshold	integer	Warn if Speed index exceeds X % of Visually complete.	required

The `MonitoringSettings` object

Real user monitoring settings.

Element	Type	Description	Required
fetchRequests	boolean	`fetch()` request capture enabled/disabled.	required
xmlHttpRequest	boolean	`XmlHttpRequest` support enabled/disabled.	required
javaScriptFrameworkSupport	JavaScriptFrameworkSupport	Support of various JavaScript frameworks.	required
contentCapture	ContentCapture	Settings for content capture.	required
excludeXhrRegex	string	You can exclude some actions from becoming XHR actions. Put a regular expression, matching all the required URLs, here. If noting specified the feature is disabled.	required
correlationHeaderInclusionRegex	string	To enable RUM for XHR calls to AWS Lambda, define a regular expression matching these calls, Dynatrace can then automatically add a custom header (x-dtc) to each such request to the respective endpoints in AWS. Important: These endpoints must accept the x-dtc header, or the requests will fail.	optional
injectionMode	string	JavaScript injection mode. The element can hold these values `CODE_SNIPPET` `CODE_SNIPPET_ASYNC` `INLINE_CODE` `JAVASCRIPT_TAG`	required
addCrossOriginAnonymousAttribute	boolean	Add the cross origin = anonymous attribute to capture JavaScript error messages and W3C resource timings.	optional
scriptTagCacheDurationInHours	integer	Time duration for the cache settings.	optional
libraryFileLocation	string	The location of your application’s custom JavaScript library file. If nothing specified the root directory of your web server is used. Required for auto-injected applications, not supported by agentless applications.	optional
monitoringDataPath	string	The location to send monitoring data from the JavaScript tag. Specify either a relative or an absolute URL. If you use an absolute URL, data will be sent using CORS. Required for auto-injected applications, optional for agentless applications.	optional
customConfigurationProperties	string	Additional JavaScript tag properties that are specific to your application. To do this, type key=value pairs separated using a (\|) symbol.	required
serverRequestPathId	string	Path to identify the server’s request ID.	required
secureCookieAttribute	boolean	Secure attribute usage for Dynatrace cookies enabled/disabled.	required
cookiePlacementDomain	string	Domain for cookie placement.	required
cacheControlHeaderOptimizations	boolean	Optimize the value of cache control headers for use with Dynatrace real user monitoring enabled/disabled.	required
advancedJavaScriptTagSettings	AdvancedJavaScriptTagSettings	Advanced JavaScript tag settings.	required
browserRestrictionSettings	WebApplicationConfigBrowserRestrictionSettings	Settings for restricting certain browser type, version, platform and, comparator. It also restricts the mode.	optional
ipAddressRestrictionSettings	WebApplicationConfigIpAddressRestrictionSettings	Settings for restricting certain ip addresses and for introducing subnet mask. It also restricts the mode.	optional
javaScriptInjectionRules	JavaScriptInjectionRules[]	Java script injection rules.	optional
angularPackageName	string	The name of the angular package.	optional

The `JavaScriptFrameworkSupport` object

Support of various JavaScript frameworks.

Element	Type	Description	Required
angular	boolean	AngularJS and Angular support enabled/disabled.	required
dojo	boolean	Dojo support enabled/disabled.	required
extJS	boolean	ExtJS, Sencha Touch support enabled/disabled.	required
icefaces	boolean	ICEfaces support enabled/disabled.	required
jQuery	boolean	jQuery, Backbone.js support enabled/disabled.	required
mooTools	boolean	MooTools support enabled/disabled.	required
prototype	boolean	Prototype support enabled/disabled.	required
activeXObject	boolean	ActiveXObject detection support enabled/disabled.	required

The `ContentCapture` object

Settings for content capture.

Element	Type	Description	Required
resourceTimingSettings	ResourceTimingSettings	Settings for resource timings capture.	required
javaScriptErrors	boolean	JavaScript errors monitoring enabled/disabled.	required
timeoutSettings	TimeoutSettings	Settings for timed action capture.	required
visuallyCompleteAndSpeedIndex	boolean	Visually complete and Speed index support enabled/disabled.	required
visuallyComplete2Settings	VisuallyComplete2Settings	Settings for VisuallyComplete2	optional

The `ResourceTimingSettings` object

Settings for resource timings capture.

Element	Type	Description	Required
w3cResourceTimings	boolean	W3C resource timings for third party/CDN enabled/disabled.	required
nonW3cResourceTimings	boolean	Timing for JavaScript files and images on non-W3C supported browsers enabled/disabled.	required
nonW3cResourceTimingsInstrumentationDelay	integer	Instrumentation delay for monitoring resource and image resource impact in browsers that don't offer W3C resource timings. Valid values range from 0 to 9999. Only effective if nonW3cResourceTimings is enabled.	required
resourceTimingCaptureType	string	Defines how detailed resource timings are captured. Only effective if w3cResourceTimings or nonW3cResourceTimings is enabled. The element can hold these values `CAPTURE_ALL_SUMMARIES` `CAPTURE_FULL_DETAILS` `CAPTURE_LIMITED_SUMMARIES`	optional
resourceTimingsDomainLimit	integer	Limits the number of domains for which W3C resource timings are captured. Only effective if resourceTimingCaptureType is `CAPTURE_LIMITED_SUMMARIES`.	optional

The `TimeoutSettings` object

Settings for timed action capture.

Element	Type	Description	Required
timedActionSupport	boolean	Timed action support enabled/disabled. Enable to detect actions that trigger sending of XHRs via setTimout methods.	required
temporaryActionLimit	integer	Defines how deep temporary actions may cascade. 0 disables temporary actions completely. Recommended value if enabled is 3.	required
temporaryActionTotalTimeout	integer	The total timeout of all cascaded timeouts that should still be able to create a temporary action	required

Element

Type

Description

Required

timedActionSupport

boolean

Timed action support enabled/disabled.

Enable to detect actions that trigger sending of XHRs via setTimout methods.

required

temporaryActionLimit

integer

Defines how deep temporary actions may cascade. 0 disables temporary actions completely. Recommended value if enabled is 3.

required

temporaryActionTotalTimeout

integer

The total timeout of all cascaded timeouts that should still be able to create a temporary action

required

The `VisuallyComplete2Settings` object

Settings for VisuallyComplete2

Element	Type	Description	Required
excludeUrlRegex	string	A RegularExpression used to exclude images and iframes from being detected by the VC module.	optional
ignoredMutationsList	string	Query selector for mutation nodes to ignore in VC and SI calculation	optional
mutationTimeout	integer	Determines the time in ms VC waits after an action closes to start calculation. Defaults to 50.	optional
inactivityTimeout	integer	The time in ms the VC module waits for no mutations happening on the page after the load action. Defaults to 1000.	optional
threshold	integer	Minimum visible area in pixels of elements to be counted towards VC and SI. Defaults to 50.	optional

The `AdvancedJavaScriptTagSettings` object

Advanced JavaScript tag settings.

Element	Type	Description	Required
syncBeaconFirefox	boolean	Send the beacon signal as a synchronous XMLHttpRequest using Firefox enabled/disabled.	optional
syncBeaconInternetExplorer	boolean	Send the beacon signal as a synchronous XMLHttpRequest using Internet Explorer enabled/disabled.	optional
instrumentUnsupportedAjaxFrameworks	boolean	Instrumentation of unsupported Ajax frameworks enabled/disabled.	required
specialCharactersToEscape	string	Additional special characters that are to be escaped using non-alphanumeric characters in HTML escape format.	required
maxActionNameLength	integer	Maximum character length for action names. Valid values range from 5 to 10000.	required
maxErrorsToCapture	integer	Maximum number of errors to be captured per page. Valid values range from 0 to 50.	required
additionalEventHandlers	AdditionalEventHandlers	Additional event handlers and wrappers.	required
eventWrapperSettings	EventWrapperSettings	In addition to the event handlers, events called using `addEventListener` or `attachEvent` can be captured. Be careful with this option! Event wrappers can conflict with the JavaScript code on a web page.	required
globalEventCaptureSettings	GlobalEventCaptureSettings	Global event capture settings.	required
userActionNameAttribute	string	User action name attribute.	optional
proxyWrapperEnabled	boolean	Proxy wrapper enabled/disabled.	optional

The `AdditionalEventHandlers` object

Additional event handlers and wrappers.

Element	Type	Description	Required
userMouseupEventForClicks	boolean	Use mouseup event for clicks enabled/disabled.	required
clickEventHandler	boolean	Click event handler enabled/disabled.	required
mouseupEventHandler	boolean	Mouseup event handler enabled/disabled.	required
blurEventHandler	boolean	Blur event handler enabled/disabled.	required
changeEventHandler	boolean	Change event handler enabled/disabled.	required
toStringMethod	boolean	toString method enabled/disabled.	required
maxDomNodesToInstrument	integer	Max. number of DOM nodes to instrument. Valid values range from 0 to 100000.	required

The `EventWrapperSettings` object

In addition to the event handlers, events called using addEventListener or attachEvent can be captured. Be careful with this option! Event wrappers can conflict with the JavaScript code on a web page.

Element	Type	Description	Required
click	boolean	Click enabled/disabled.	required
mouseUp	boolean	MouseUp enabled/disabled.	required
change	boolean	Change enabled/disabled.	required
blur	boolean	Blur enabled/disabled.	required
touchStart	boolean	TouchStart enabled/disabled.	required
touchEnd	boolean	TouchEnd enabled/disabled.	required

The `GlobalEventCaptureSettings` object

Global event capture settings.

Element	Type	Description	Required
mouseUp	boolean	MouseUp enabled/disabled.	required
mouseDown	boolean	MouseDown enabled/disabled.	required
click	boolean	Click enabled/disabled.	required
doubleClick	boolean	DoubleClick enabled/disabled.	required
keyUp	boolean	KeyUp enabled/disabled.	required
keyDown	boolean	KeyDown enabled/disabled.	required
scroll	boolean	Scroll enabled/disabled.	required
additionalEventCapturedAsUserInput	string	Additional events to be captured globally as user input. For example, DragStart or DragEnd.	required

The `WebApplicationConfigBrowserRestrictionSettings` object

Settings for restricting certain browser type, version, platform and, comparator. It also restricts the mode.

Element	Type	Description	Required
mode	string	The mode of the list of browser restrictions. The element can hold these values `EXCLUDE` `INCLUDE`	required
browserRestrictions	WebApplicationConfigBrowserRestriction[]	A list of browser restrictions.	optional

The `WebApplicationConfigBrowserRestriction` object

Browser exclusion rules for the browsers that are to be excluded.

Element	Type	Description	Required
browserVersion	string	The version of the browser that is used.	optional
browserType	string	The type of the browser that is used. The element can hold these values `ANDROID_WEBKIT` `BOTS_SPIDERS` `CHROME` `EDGE` `FIREFOX` `INTERNET_EXPLORER` `OPERA` `SAFARI`	required
platform	string	The platform on which the browser is being used. The element can hold these values `ALL` `DESKTOP` `MOBILE`	optional
comparator	string	Compares different browsers together. The element can hold these values `EQUALS` `GREATER_THAN_OR_EQUAL` `LOWER_THAN_OR_EQUAL`	optional

The `WebApplicationConfigIpAddressRestrictionSettings` object

Settings for restricting certain ip addresses and for introducing subnet mask. It also restricts the mode.

Element	Type	Description	Required
mode	string	The mode of the list of ip address restrictions. The element can hold these values `EXCLUDE` `INCLUDE`	required
ipAddressRestrictions	IpAddressRange[]	-	optional

The `IpAddressRange` object

The IP address or the IP address range to be mapped to the location.

Element	Type	Description	Required
subnetMask	integer	The subnet mask of the IP address range.	optional
address	string	The IP address to be mapped. For an IP address range, this is the from address.	required
addressTo	string	The to address of the IP address range.	optional

Element

Type

Description

Required

subnetMask

integer

The subnet mask of the IP address range.

optional

address

string

The IP address to be mapped.

For an IP address range, this is the from address.

required

addressTo

string

The to address of the IP address range.

optional

The `JavaScriptInjectionRules` object

Rules for javascript injection

Element	Type	Description	Required
enabled	boolean	The enable or disable rule of the java script injection.	required
urlOperator	string	The url operator of the java script injection. The element can hold these values `ALL_PAGES` `CONTAINS` `ENDS_WITH` `EQUALS` `STARTS_WITH`	required
urlPattern	string	The url pattern of the java script injection.	optional
rule	string	The url rule of the java script injection. The element can hold these values `AFTER_SPECIFIC_HTML` `AUTOMATIC_INJECTION` `BEFORE_SPECIFIC_HTML` `DO_NOT_INJECT`	required
htmlPattern	string	The html pattern of the java script injection.	optional
target	string	The target against which the rule of the java script injection should be matched. The element can hold these values `PAGE_QUERY` `URL`	optional

The `UserTag` object

Defines UserTags settings of an application.

Element	Type	Description	Required
uniqueId	integer	uniqueId, unique among all userTags and properties of this application	required
metadataId	integer	If it's of type metaData, metaData id of the userTag	optional
cleanupRule	string	Cleanup rule expression of the userTag	optional
serverSideRequestAttribute	string	requestAttribute Id of the userTag	optional
ignoreCase	boolean	If true, the value of this tag will always be stored in lower case. Defaults to false.	optional

The `UserActionAndSessionProperties` object

Defines userAction and session custom defined properties settings of an application.

Element	Type	Description	Required
displayName	string	The display name of the property.	optional
type	string	The data type of the property. The element can hold these values `DATE` `DOUBLE` `LONG` `LONG_STRING` `STRING`	required
origin	string	The origin of the property The element can hold these values `JAVASCRIPT_API` `META_DATA` `SERVER_SIDE_REQUEST_ATTRIBUTE`	required
aggregation	string	The aggregation type of the property. It defines how multiple values of the property are aggregated. The element can hold these values `AVERAGE` `FIRST` `LAST` `MAXIMUM` `MINIMUM` `SUM`	optional
storeAsUserActionProperty	boolean	If `true`, the property is stored as a user action property	optional
storeAsSessionProperty	boolean	If `true`, the property is stored as a session property	optional
cleanupRule	string	The cleanup rule of the property. Defines how to extract the data you need from a string value. Specify the regular expression for the data you need there.	optional
serverSideRequestAttribute	string	The ID of the request attribute. Only applicable when the origin is set to `SERVER_SIDE_REQUEST_ATTRIBUTE`.	optional
uniqueId	integer	Unique id among all userTags and properties of this application	required
key	string	Key of the property	required
metadataId	integer	If the origin is META_DATA, metaData id of the property	optional
ignoreCase	boolean	If true, the value of this property will always be stored in lower case. Defaults to false.	optional
longStringLength	integer	If the type is LONG_STRING, the max length for this property. Must be a multiple of 100. Defaults to 200.	optional

The `UserActionNamingSettings` object

The settings of user action naming.

Element	Type	Description	Required
placeholders	UserActionNamingPlaceholder[]	User action placeholders.	optional
loadActionNamingRules	UserActionNamingRule[]	User action naming rules for loading actions.	optional
xhrActionNamingRules	UserActionNamingRule[]	User action naming rules for xhr actions.	optional
customActionNamingRules	UserActionNamingRule[]	User action naming rules for custom actions.	optional
ignoreCase	boolean	Case insensitive naming.	optional
useFirstDetectedLoadAction	boolean	First load action found under an XHR action should be used when true. Else the deepest one under the xhr action is used	optional
splitUserActionsByDomain	boolean	Deactivate this setting if different domains should not result in separate user actions.	optional
queryParameterCleanups	string[]	List of parameters that should be removed from the query before using the query in the user action name.	optional

The `UserActionNamingPlaceholder` object

The placeholder settings.

Element	Type	Description	Required
name	string	Placeholder name.	required
input	string	Input. The element can hold these values `ELEMENT_IDENTIFIER` `INPUT_TYPE` `METADATA` `PAGE_TITLE` `PAGE_URL` `SOURCE_URL` `TOP_XHR_URL` `XHR_URL`	required
processingPart	string	Part. The element can hold these values `ALL` `ANCHOR` `PATH`	required
processingSteps	UserActionNamingPlaceholderProcessingStep[]	Processing actions.	optional
metadataId	integer	Id of the metadata.	optional
useGuessedElementIdentifier	boolean	Use the element identifier that was selected by Dynatrace.	required

The `UserActionNamingPlaceholderProcessingStep` object

The processing step settings.

Element	Type	Description	Required
type	string	An action to be taken by the processing: `SUBSTRING`: Extracts the string between patternBefore and patternAfter. `REPLACEMENT`: Replaces the string between patternBefore and patternAfter with the specified replacement. `REPLACE_WITH_PATTERN`: Replaces the patternToReplace with the specified replacement. `EXTRACT_BY_REGULAR_EXPRESSION`: Extracts the part of the string that matches the regularExpression. `REPLACE_WITH_REGULAR_EXPRESSION`: Replaces all occurrences that match regularExpression with the specified replacement. `REPLACE_IDS`: Replaces all IDs and UUIDs with the specified replacement. The element can hold these values `EXTRACT_BY_REGULAR_EXPRESSION` `REPLACEMENT` `REPLACE_IDS` `REPLACE_WITH_PATTERN` `REPLACE_WITH_REGULAR_EXPRESSION` `SUBSTRING`	required
patternBefore	string	The pattern before the required value. It will be removed.	optional
patternBeforeSearchType	string	The required occurrence of patternBefore. The element can hold these values `FIRST` `LAST`	optional
patternAfter	string	The pattern after the required value. It will be removed.	optional
patternAfterSearchType	string	The required occurrence of patternAfter. The element can hold these values `FIRST` `LAST`	optional
replacement	string	Replacement for the original value.	optional
patternToReplace	string	The pattern to be replaced. Only applicable if the type is `REPLACE_WITH_PATTERN`.	optional
regularExpression	string	A regular expression for the string to be extracted or replaced. Only applicable if the type is `EXTRACT_BY_REGULAR_EXPRESSION` or `REPLACE_WITH_REGULAR_EXPRESSION`.	optional
fallbackToInput	boolean	If set to true: Returns the input if patternBefore or patternAfter cannot be found and the type is `SUBSTRING`. Returns the input if regularExpression doesn't match and type is `EXTRACT_BY_REGULAR_EXPRESSION`. Otherwise null is returned.	optional

The `UserActionNamingRule` object

The settings of naming rule.

Element	Type	Description	Required
template	string	Naming pattern. Use Curly brackets `{}` to select placeholders.	required
conditions	UserActionNamingRuleCondition[]	Defines the conditions when the naming rule should apply.	optional
useOrConditions	boolean	If set to `true` the conditions will be connected by logical OR instead of logical AND.	optional

The `UserActionNamingRuleCondition` object

The settings of conditions for user action naming.

Element	Type	Description	Required
operand1	string	Must be a defined placeholder wrapped in curly braces	required
operand2	string	Must be null if operator is "IS_EMPTY", a regex if operator is "MATCHES_REGULAR_ERPRESSION". In all other cases the value can be a freetext or a placeholder wrapped in curly braces	optional
operator	string	The operator of the condition The element can hold these values `CONTAINS` `ENDS_WITH` `EQUALS` `IS_EMPTY` `IS_NOT_EMPTY` `MATCHES_REGULAR_EXPRESSION` `NOT_CONTAINS` `NOT_ENDS_WITH` `NOT_EQUALS` `NOT_MATCHES_REGULAR_EXPRESSION` `NOT_STARTS_WITH` `STARTS_WITH`	required

The `MetaDataCapturing` object

Configuration to capture meta data with the JavaScript agent.

Element	Type	Description	Required
type	string	The type of the meta data to capture. The element can hold these values `COOKIE` `CSS_SELECTOR` `JAVA_SCRIPT_FUNCTION` `JAVA_SCRIPT_VARIABLE` `META_TAG` `QUERY_STRING` `RESPONSE_HEADER`	required
capturingName	string	The name of the meta data to capture.	required
name	string	Name for displaying the captured values in Dynatrace.	required
uniqueId	integer	The unique id of the meta data to capture.	optional
publicMetadata	boolean	True if this metadata should be captured regardless of the privacy settings	optional
useLastValue	boolean	True if the last captured value should be used for this metadata. By default the first value will be used.	optional

The `ConversionGoal` object

A conversion goal of the application.

Element	Type	Description	Required
name	string	The name of the conversion goal.	required
id	string	The ID of conversion goal. Omit it while creating a new conversion goal.	optional
type	string	The type of the conversion goal. The element can hold these values `Destination` `UserAction` `VisitDuration` `VisitNumActions`	optional
destinationDetails	DestinationDetails	Configuration of a destination-based conversion goal.	optional
userActionDetails	UserActionDetails	Configuration of a user action-based conversion goal.	optional
visitDurationDetails	VisitDurationDetails	Configuration of a visit duration-based conversion goal.	optional
visitNumActionDetails	VisitNumActionDetails	Configuration of a number of user actions-based conversion goal.	optional

The `DestinationDetails` object

Configuration of a destination-based conversion goal.

Element	Type	Description	Required
urlOrPath	string	The path to be reached to hit the conversion goal.	required
matchType	string	The operator of the match. The element can hold these values `Begins` `Contains` `Ends`	optional
caseSensitive	boolean	The match is case-sensitive (`true`) or (`false`).	optional

The `UserActionDetails` object

Configuration of a user action-based conversion goal.

Element	Type	Description	Required
value	string	The value to be matched to hit the conversion goal.	optional
caseSensitive	boolean	The match is case-sensitive (`true`) or (`false`).	optional
matchType	string	The operator of the match. The element can hold these values `Begins` `Contains` `Ends`	optional
matchEntity	string	The type of the entity to which the rule applies. The element can hold these values `ActionName` `CssSelector` `JavaScriptVariable` `MetaTag` `PagePath` `PageTitle` `PageUrl` `UrlAnchor` `XhrUrl`	optional
actionType	string	Type of the action to which the rule applies. The element can hold these values `Custom` `Load` `Xhr`	optional

The `VisitDurationDetails` object

Configuration of a visit duration-based conversion goal.

Element	Type	Description	Required
durationInMillis	integer	The duration of session to hit the conversion goal, in milliseconds.	required

The `VisitNumActionDetails` object

Configuration of a number of user actions-based conversion goal.

Element	Type	Description	Required
numUserActions	integer	The number of user actions to hit the conversion goal.	optional

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

json
{
  "name": "application name",
  "type": "AUTO_INJECTED",
  "realUserMonitoringEnabled": true,
  "sessionReplayConfig": {
    "costControlPercentage": 100,
    "enabled": true,
    "enableCssResourceCapturing": true,
    "cssResourceCapturingExclusionRules": [
      "rule"
    ]
  },
  "costControlUserSessionPercentage": 100,
  "loadActionKeyPerformanceMetric": "VISUALLY_COMPLETE",
  "xhrActionKeyPerformanceMetric": "ACTION_DURATION",
  "loadActionApdexSettings": {
    "toleratedThreshold": 3000,
    "frustratingThreshold": 12000,
    "toleratedFallbackThreshold": 3000,
    "frustratingFallbackThreshold": 12000
  },
  "xhrActionApdexSettings": {
    "toleratedThreshold": 2500,
    "frustratingThreshold": 10000,
    "toleratedFallbackThreshold": 3000,
    "frustratingFallbackThreshold": 12000
  },
  "customActionApdexSettings": {
    "toleratedThreshold": 3000,
    "frustratingThreshold": 12000,
    "toleratedFallbackThreshold": 3000,
    "frustratingFallbackThreshold": 12000
  },
  "waterfallSettings": {
    "uncompressedResourcesThreshold": 860,
    "resourcesThreshold": 100000,
    "resourceBrowserCachingThreshold": 50,
    "slowFirstPartyResourcesThreshold": 200000,
    "slowThirdPartyResourcesThreshold": 200000,
    "slowCdnResourcesThreshold": 200000,
    "speedIndexVisuallyCompleteRatioThreshold": 50
  },
  "monitoringSettings": {
    "fetchRequests": false,
    "xmlHttpRequest": true,
    "javaScriptFrameworkSupport": {
      "angular": true,
      "dojo": false,
      "extJS": false,
      "icefaces": false,
      "jQuery": true,
      "mooTools": false,
      "prototype": true,
      "activeXObject": false
    },
    "contentCapture": {
      "resourceTimingSettings": {
        "w3cResourceTimings": true,
        "nonW3cResourceTimings": false,
        "nonW3cResourceTimingsInstrumentationDelay": 50
      },
      "javaScriptErrors": true,
      "timeoutSettings": {
        "timedActionSupport": false,
        "temporaryActionLimit": 0,
        "temporaryActionTotalTimeout": 100
      },
      "visuallyCompleteAndSpeedIndex": true
    },
    "excludeXhrRegex": "",
    "correlationHeaderInclusionRegex": "",
    "injectionMode": "JAVASCRIPT_TAG",
    "libraryFileLocation": "",
    "monitoringDataPath": "",
    "customConfigurationProperties": "",
    "serverRequestPathId": "",
    "secureCookieAttribute": false,
    "cookiePlacementDomain": "",
    "cacheControlHeaderOptimizations": true,
    "advancedJavaScriptTagSettings": {
      "syncBeaconFirefox": false,
      "syncBeaconInternetExplorer": false,
      "instrumentUnsupportedAjaxFrameworks": false,
      "specialCharactersToEscape": "",
      "maxActionNameLength": 100,
      "maxErrorsToCapture": 10,
      "additionalEventHandlers": {
        "userMouseupEventForClicks": false,
        "clickEventHandler": false,
        "mouseupEventHandler": false,
        "blurEventHandler": false,
        "changeEventHandler": false,
        "toStringMethod": false,
        "maxDomNodesToInstrument": 5000
      },
      "eventWrapperSettings": {
        "click": false,
        "mouseUp": false,
        "change": false,
        "blur": false,
        "touchStart": false,
        "touchEnd": false
      },
      "globalEventCaptureSettings": {
        "mouseUp": true,
        "mouseDown": true,
        "click": true,
        "doubleClick": true,
        "keyUp": true,
        "keyDown": true,
        "scroll": true,
        "additionalEventCapturedAsUserInput": ""
      }
    },
    "browserRestrictionSettings": {
      "browserRestrictions": [
        {
          "browserType": "INTERNET_EXPLORER",
          "browserVersion": "0",
          "platform": "ALL",
          "comparator": "EQUALS"
        }
      ],
      "mode": "EXCLUDE"
    },
    "javaScriptInjectionRules": [
      {
        "enabled": true,
        "urlOperator": "CONTAINS",
        "urlPattern": "/lorem/ipsum.jsp",
        "rule": "AFTER_SPECIFIC_HTML",
        "htmlPattern": "</title>"
      }
    ],
    "ipAddressRestrictionSettings": {
      "ipAddressRestrictions": [
        {
          "subnetMask": 3,
          "address": "10.0.0.1"
        },
        {
          "address": "10.0.0.1",
          "addressTo": "10.0.0.2"
        }
      ],
      "mode": "EXCLUDE"
    }
  },
  "userActionNamingSettings": {
    "placeholders": [
      {
        "name": "myPlaceholder",
        "input": "PAGE_URL",
        "processingPart": "ALL",
        "processingSteps": [
          {
            "type": "SUBSTRING",
            "patternBefore": ".*b",
            "patternBeforeSearchType": "FIRST",
            "patternAfter": ".*a",
            "patternAfterSearchType": "LAST",
            "replacement": "value"
          }
        ],
        "useGuessedElementIdentifier": false
      }
    ],
    "loadActionNamingRules": [
      {
        "template": "Loading of {myPlaceholder}",
        "conditions": [
          {
            "operand1": "{myPlaceholder}",
            "operand2": "foo",
            "operator": "CONTAINS"
          }
        ]
      }
    ],
    "xhrActionNamingRules": [
      {
        "template": "Loading of {myPlaceholder}",
        "conditions": [
          {
            "operand1": "{myPlaceholder}",
            "operand2": "foo",
            "operator": "CONTAINS"
          }
        ]
      }
    ],
    "ignoreCase": true,
    "splitUserActionsByDomain": true
  },
  "metaDataCaptureSettings": [
    {
      "type": "JAVA_SCRIPT_VARIABLE",
      "capturingName": "variableName",
      "name": "display name"
    }
  ],
  "conversionGoals": [
    {
      "name": "conversionGoalName",
      "type": "UserAction",
      "destinationDetails": {
        "urlOrPath": "url or path",
        "matchType": "Begins",
        "caseSensitive": false
      },
      "userActionDetails": {
        "value": "value to match",
        "caseSensitive": true,
        "matchType": "Ends",
        "matchEntity": "ActionName",
        "actionType": "Load"
      },
      "visitDurationDetails": {
        "durationInMillis": 1
      },
      "visitNumActionDetails": {
        "numUserActions": 2
      }
    }
  ]
}

Response

Response codes

Code	Type	Description
201	EntityShortRepresentation	Success. The new configuration has been created. The response body contains the ID and name of the new web application.
204		Success. Configuration has been updated. Response doesn't have a body.
400	ErrorEnvelope	Failed. The input is invalid.

Response body objects

The `EntityShortRepresentation` object

The short representation of a Dynatrace entity.

Element	Type	Description
id	string	The ID of the Dynatrace entity.
name	string	The name of the Dynatrace entity.
description	string	A short description of the Dynatrace entity.

Response body JSON model

json
{
  "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
  "name": "Dynatrace entity",
  "description": "Dynatrace entity for the REST API example"
}

Validate payload

We recommend that you validate the payload before submitting it with an actual request. A response code of 204 indicates a valid payload.

The request consumes an application/json payload.

POST	ManagedDynatrace for Government	`https://{your-domain}/e/{your-environment-id}/api/config/v1/applications/web/{id}/validator`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/config/v1/applications/web/{id}/validator`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/applications/web/{id}/validator`

Authentication

To execute this request, you need an access token with WriteConfig scope.

To learn how to obtain and use it, see Tokens and authentication.

Response

Response codes

Code	Type	Description
204		Validated. The submitted configuration is valid. Response does not have a body.
400	ErrorEnvelope	Failed. The input is invalid.

Web application configuration API - PUT a web application

Authentication

Parameters

Request body objects

The WebApplicationConfig object

The ConfigurationMetadata object

The SessionReplaySetting object

The Apdex object

The WaterfallSettings object

The MonitoringSettings object

The JavaScriptFrameworkSupport object

The ContentCapture object

The ResourceTimingSettings object

The TimeoutSettings object

The VisuallyComplete2Settings object

The AdvancedJavaScriptTagSettings object

The AdditionalEventHandlers object

The EventWrapperSettings object

The GlobalEventCaptureSettings object

The WebApplicationConfigBrowserRestrictionSettings object

The WebApplicationConfigBrowserRestriction object

The WebApplicationConfigIpAddressRestrictionSettings object

The IpAddressRange object

The JavaScriptInjectionRules object

The UserTag object

The UserActionAndSessionProperties object

The UserActionNamingSettings object

The UserActionNamingPlaceholder object

The UserActionNamingPlaceholderProcessingStep object

The UserActionNamingRule object

The UserActionNamingRuleCondition object

The MetaDataCapturing object

The ConversionGoal object

The DestinationDetails object

The UserActionDetails object

The VisitDurationDetails object

The VisitNumActionDetails object

Request body JSON model

Response

Response codes

Response body objects

The EntityShortRepresentation object

Response body JSON model

Validate payload

Authentication

Response

Response codes

The `WebApplicationConfig` object

The `ConfigurationMetadata` object

The `SessionReplaySetting` object

The `Apdex` object

The `WaterfallSettings` object

The `MonitoringSettings` object

The `JavaScriptFrameworkSupport` object

The `ContentCapture` object

The `ResourceTimingSettings` object

The `TimeoutSettings` object

The `VisuallyComplete2Settings` object

The `AdvancedJavaScriptTagSettings` object

The `AdditionalEventHandlers` object

The `EventWrapperSettings` object

The `GlobalEventCaptureSettings` object

The `WebApplicationConfigBrowserRestrictionSettings` object

The `WebApplicationConfigBrowserRestriction` object

The `WebApplicationConfigIpAddressRestrictionSettings` object

The `IpAddressRange` object

The `JavaScriptInjectionRules` object

The `UserTag` object

The `UserActionAndSessionProperties` object

The `UserActionNamingSettings` object

The `UserActionNamingPlaceholder` object

The `UserActionNamingPlaceholderProcessingStep` object

The `UserActionNamingRule` object

The `UserActionNamingRuleCondition` object

The `MetaDataCapturing` object

The `ConversionGoal` object

The `DestinationDetails` object

The `UserActionDetails` object

The `VisitDurationDetails` object

The `VisitNumActionDetails` object

The `EntityShortRepresentation` object