Settings API - URL path pattern matching schema table

Published Sep 25, 2025

URL path pattern matching (`builtin:url-path-pattern-matching-rules)`

Define rules to match URL patterns out of URL paths

Schema ID	Schema groups	Scope
`builtin:url-path-pattern-matching-rules`	`group:service-detection`	`CLOUD_APPLICATION_NAMESPACE` - Kubernetes namespace `KUBERNETES_CLUSTER` - Kubernetes cluster `HOST_GROUP` - Host Group `environment`

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

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
Enabled `enabled`	boolean	If enabled, the rule will be evaluated.	required
Rule `rule`	Rule	-	required

The `Rule` object

Property	Type	Description	Required
Rule name `ruleName`	text	-	required
Description `description`	text	-	optional
Matching condition `condition`	text	Limits the scope of the service splitting rule using DQL matcher conditions on resource attributes. A rule is applied only if the condition matches, otherwise the ruleset evaluation continues. If empty, the condition will always match.	optional
URL path patterns `urlPathPatterns`	list	First matching pattern defines the resulting url.path.pattern attribute value. And here is a nice documentation	required