Applications detection rules API - POST a rule

Creates a new application detection rule and adds it to the end of the rules list. To enforce a particular order, use the PUT reorder rules request.

You can create detection rules only for an existing application. If you need to create a rule for an application that doesn't exist yet, create an application first and then configure detection rules for it.

The request consumes and produces an application/json payload.

  • Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/applicationDetectionRules
  • SaaS https://{your-environment-id}


The body must not provide an ID. An ID is assigned automatically by the Dynatrace server.

Parameter Type Description In Required
body ApplicationDetectionRuleConfig

JSON body of the request containing definition of the new application detection rule.

You must neither specify ID nor order of the rule.

body optional
position string

By default, the new rule will be inserted in an appropriate spot. To customize the ordering of the new rule, set to PREPEND to prepend it to the list, APPEND to append it.

The position element can hold these values.
query optional

The ApplicationDetectionRuleConfig object

Element Type Description Required
metadata ConfigurationMetadataDtoImpl

Metadata useful for debugging.

id string

The unique ID of the rule.

When adding a new rule, you can either specify your own ID, or don't specify anything, in that case the ID will be generated automatically.

order string

The order string. Sorting application detection rules alphabetically by their order string determines their relative ordering.

Typically this is managed by Dynatrace internally and will not be present in GET responses.

applicationIdentifier string

The identifier of the application, for example APPLICATION-4A3B43. You must use an existing ID.

filterConfig ApplicationFilter

Defines how to identify an application.


The ApplicationFilter object

Defines how to identify an application.

Element Type Description Required
pattern string

The string to look for.

applicationMatchType string

Defines the matching rule.

The applicationMatchType element can hold these values.
applicationMatchTarget string

Defines where to look for the string.

The applicationMatchTarget element can hold these values.

The ConfigurationMetadataDtoImpl object

Metadata useful for debugging

Element Type Description Required
configurationVersions integer[]

A Sorted list of the version numbers of the configuration.

clusterVersion string

Dynatrace server version.


Possible values

Possible values for the position element:


Possible values for the applicationMatchTarget element in the ApplicationFilter object:

  • URL

Possible values for the applicationMatchType element in the ApplicationFilter object:


Response format

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.

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.

The request consumes an application/json payload.

  • Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/applicationDetectionRules/validator
  • SaaS https://{your-environment-id}

Response codes

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


In this example, the request creates a new application detection rule for the BookingApp application that has the ID of APPLICATION-900C1E36674F607D.

The API token is passed in the Authorization header.

The request body is truncated in the Curl section. See the Request body section for the full body. You can download or copy the example request body to try it out on your own. Be sure to use an application ID that is available in your environment.


curl -X POST \ \
  -H 'Authorization: Api-token abcdefjhij1234567890' \
  -H 'Content-Type: application/json' \  
  -d '{ <truncated - see the Request body section > }'

Request URL

Request body

  "applicationIdentifier": "APPLICATION-900C1E36674F607D",
  "filterConfig": {
    "pattern": "booking",
    "applicationMatchType": "CONTAINS",
    "applicationMatchTarget": "URL"

Response body

  "id": "9568a82b-73d8-4b18-be1a-4289433e2619",
  "name": "BookingApp"

Response code



The new application detection rule looks like this in the UI:

POST example