Custom services API - PUT reorder rules

Custom service rules are evaluated from top to bottom; the first matching rule applies.

This request reorders the custom service rules according to the order of the IDs in the body of the request. Rules that are omitted from 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/service/customServices/{technology}/order
  • SaaS https://{your-environment-id}{technology}/order
  • Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/service/customServices/{technology}/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
technology string

Technology of custom services to update.

path required
body StubList

JSON body of the request containing the IDs of the custom services in the desired order. Any further properties (name, description) will be 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. Custom services have been updated. Response doesn't have a body.


Failed. The input is invalid

Response body

A successful request doesn't return any content.