Reorder settings objects

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Reorder the objects of a multi-object, ordered Dynatrace settings schema with the Settings API by sending the new order of object IDs.

Overview

You use this operation to set the order of settings objects for a schema that is multi-object and ordered. The request body sets the schemaId, the scope, and the new order of object IDs, and the required optimistic-locking-version query parameter detects whether any of the objects changed in the meantime.

Authentication

To execute this request, you need a platform token or OAuth access token with settings:objects:write scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

{
  "schemaId": "builtin:schema",
  "scope": "environment",
  "sections": [
    {
      "firstObjectId": "string",
      "lastObjectId": "string",
      "order": [
        {
          "objectId": "string"
        }
      ]
    }
  ]
}

Response

{
  "version": "string",
  "items": [
    {
      "objectId": "string",
      "version": "string"
    }
  ]
}