Applications detection rules API - PUT reorder rules

Application detection rules are evaluated from top to bottom, the first matching rule applies.

This request reorders the application detection rules according to the order of the IDs in the body of the request. Rules that are omitted in the body of the request will retain their relative order but will be placed after all those present in the request.

The request consumes an application/json payload.

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


To execute this request, you need the Write configuration (WriteConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.


Parameter Type Description In Required
body StubList

The JSON body of the request. Contains the IDs of the application detection rules in the desired order. Any further properties (name, description) are ignored.

body optional

Body format

The StubList object

An ordered list of short representations of Dynatrace entities.

Element Type Description Required
values EntityShortRepresentation[]

An ordered list of short representations of Dynatrace entities.


The EntityShortRepresentation object

The short representation of a Dynatrace entity.

Element Type Description Required
id string

The ID of the Dynatrace entity.



Response codes

Code Description

Success. Application detection rules have been reordered. Response doesn't have a body.


Failed. The input is invalid.

Response body

A successful request doesn't return any content.


In this example, the request reorders the detection rules from GET all rules request example, enforcing the following order:

  • PaymentProcessing
  • BookingApp
  • easyTravel


curl -X PUT \ \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
  -H 'Content-Type: application/json' \  
  -d '{ <truncated - see the Request body section > }'

Request URL

Request body

  "values": [
      "id": "498a4b9a-d551-4556-ac9a-4075200b28ae",
      "name": "PaymentProcessing"
      "id": "9568a82b-73d8-4b18-be1a-4289433e2619",
      "name": "BookingApp"
      "id": "95b22afb-4e3d-4f9f-a37d-81bc3d388a33",
      "name": "easyTravel"

Response code