Settings API - Synthetic monitor's primary grail tags schema table

Published Nov 10, 2025

Synthetic monitor's primary grail tags (`builtin:synthetic.primary-grail-tags)`

Set synthetic monitor's primary grail tags.

Schema ID	Schema groups	Scope
`builtin:synthetic.primary-grail-tags`	-	`SYNTHETIC_TEST` - Synthetic monitor `HTTP_CHECK` - HTTP monitor `MULTIPROTOCOL_MONITOR` - Network availability monitor

Retrieve schema via Settings API


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

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
Primary grail tags `tags`	Set<PrimaryGrailTag>	-	Required

The `PrimaryGrailTag` object

Property	Type	Description	Required
Primary grail tag's key `key`	text	-	Required
Primary grail tag's value `value`	text	-	Required