Settings API - Settings zones schema table

Published Sep 25, 2025

Settings zones (`builtin:settings-zones)`

Settings zones enable defining fine grained access rights to parts of an environment.

Schema ID	Schema groups	Scope
`builtin:settings-zones`	`group:preferences`	`environment`

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

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
Settings zone id `id`	text	-	required
Settings zone display name `displayName`	text	-	optional
Entity selector rules `entitySelectorRules`	Set<EntitySelectorRule>	-	required

The `EntitySelectorRule` object

Property	Type	Description	Required
Enabled `enabled`	boolean	-	required
Monitored entity type `meType`	enum	Rules can only be applied to the selected type `SERVICE`	required
Entity selector `entitySelector`	text	The documentation of the entity selector can be found here. The type is optional here (already defined above).	required