Settings API - Configuration schema table

Published Sep 25, 2025

Configuration (`builtin:synthetic.browser.configuration)`

Configuration

Schema ID	Schema groups	Scope
`builtin:synthetic.browser.configuration`	`group:synthetic.browser`	`SYNTHETIC_TEST` - Synthetic monitor

Retrieve schema via Settings API

GET	Managed	`https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:synthetic.browser.configuration`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:synthetic.browser.configuration`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:synthetic.browser.configuration`

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

Property	Type	Description	Required
Monitor frames `monitorFrames`	boolean	-	Required
Bypass CSP `bypassCSP`	boolean	-	Required
Bypass CSP `useIESupportedAgent`	boolean	-	Required
User agent `userAgent`	text	-	Required
Proxy `proxy`	Proxy	-	Optional
`ignoredErrorCodes`	IgnoredErrorCodes	-	Optional
`browserPermissions`	BrowserPermissions	-	Optional
`chromiumStartupFlags`	ChromiumStartupFlags	-	Required
`javaScriptSettings`	JavaScriptSettings	-	Optional
`blockedRequests`	list	-	Required
`filteredRequests`	FilteredRequests	-	Optional
`requestHeaderOptions`	RequestHeaderOptions	-	Optional
Device `device`	TestDevice	-	Required
Network throttling `networkThrottling`	NetworkThrottling	-	Optional
User certificates `clientCertificates`	ClientCertificate[]	-	Required
Experimental properties list. `experimentalProperties`	NameValueEntry[]	-	Required
`cookies`	Set<CookieEntry>	-	Required

The `Proxy` object

Property	Type	Description	Required
pacUrl `pacUrl`	text	-	Required

The `IgnoredErrorCodes` object

Property	Type	Description	Required
`statusCodes`	text	-	Required
`matchingPattern`	text	-	Required

The `BrowserPermissions` object

Property	Type	Description	Required
Allow notifications `notifications`	boolean	-	Required
Allow location access `location`	boolean	-	Required
Allow camera access `camera`	boolean	-	Required
Allow microphone access `microphone`	boolean	-	Required

The `ChromiumStartupFlags` object

Property	Type	Description	Required
disable-web-security `disable-web-security`	boolean	-	Required
ignore-certificate-errors `ignore-certificate-errors`	boolean	-	Optional
test-type `test-type`	boolean	-	Optional
disable-features `disable-features`	Set<NameStateEntry>	-	Required
ssl-version-min `ssl-version-min`	text	-	Optional
ssl-version-max `ssl-version-max`	text	-	Optional
autoplay-policy `autoplay-policy`	enum	The element has these enums `no-user-gesture-required` `document-user-activation-required`	Optional
host-resolver-rules `host-resolver-rules`	text	-	Optional
disable-site-isolation-trials `disable-site-isolation-trials`	boolean	-	Optional

The `JavaScriptSettings` object

Property	Type	Description	Required
`fetchRequests`	boolean	-	Required
`xmlHttpRequests`	boolean	-	Required
`javaScriptErrors`	boolean	-	Optional
`timedActions`	boolean	-	Required
`timeoutSettings`	TimeoutSettings	-	Optional
`javaScriptFrameworkSupport`	JavaScriptFrameworkSupport	-	Optional
`customProperties`	text	-	Optional
`visuallyCompleteOptions`	VisuallyCompleteOptions	-	Optional
`experimentalValues`	boolean	-	Required

The `FilteredRequests` object

Property	Type	Description	Required
`mode`	enum	The element has these enums `BLOCK` `ALLOW`	Required
`requests`	RequestFilter[]	-	Required

The `RequestHeaderOptions` object

Property	Type	Description	Required
`requestHeaders`	NameValueEntry[]	-	Required
`matchingPatterns`	set	-	Required

The `TestDevice` object

Property	Type	Description	Required
`name`	text	-	Required
`mobile`	boolean	-	Required
`touchEnabled`	boolean	-	Required
`width`	integer	-	Required
`height`	integer	-	Required

The `NetworkThrottling` object

Property	Type	Description	Required
`name`	text	-	Required
`latency`	integer	-	Required
`download`	integer	-	Required
`upload`	integer	-	Required

The `ClientCertificate` object

Property	Type	Description	Required
Domain `domain`	text	-	Required
Credential ID `credentialId`	text	-	Required

The `CookieEntry` object

Property	Type	Description	Required
Name `name`	text	Enclose placeholder values in brackets, for example {email}	Required
Value `value`	text	Enclose placeholder values in brackets, for example {email}	Required
Domain `domain`	text	Enclose placeholder values in brackets, for example {email}	Required
Path (optional) `path`	text	Enclose placeholder values in brackets, for example {email}	Optional

The `NameStateEntry` object

Property	Type	Description	Required
`name`	text	-	Required
`state`	boolean	-	Required

The `TimeoutSettings` object

Property	Type	Description	Required
`temporaryActionLimit`	integer	-	Required
`temporaryActionTotalTimeout`	integer	-	Required

The `JavaScriptFrameworkSupport` object

Property	Type	Description	Required
`angular`	boolean	-	Required
`dojo`	boolean	-	Required
`extJs`	boolean	-	Required
`prototype`	boolean	-	Required
`jQuery`	boolean	-	Required
`activeXObject`	boolean	-	Required
`mooTools`	boolean	-	Required
`icefaces`	boolean	-	Required

The `VisuallyCompleteOptions` object

Property	Type	Description	Required
`imageSizeThreshold`	integer	-	Required
`inactivityTimeout`	integer	-	Required
`mutationTimeout`	integer	-	Required
`excludedUrls`	list	-	Required
`excludedElements`	list	-	Required

The `RequestFilter` object

Property	Type	Description	Required
`type`	enum	The element has these enums `STARTS_WITH` `ENDS_WITH` `CONTAINS` `EQUALS` `REGEX`	Required
`matchingPattern`	text	-	Required

The `NameValueEntry` object

Property	Type	Description	Required
`name`	text	-	Required
`value`	text	-	Required