Create a settings object

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Create a new Dynatrace settings object with the Settings API, or validate the submitted object without saving it by setting validate-only to true.

Overview

You use this operation to create a settings object from the values in the request body. Set the validate-only query parameter to true to only validate the submitted object without saving it, for example in a CI check. With the admin-access query parameter set to true and the settings:objects:admin permission, you can act on objects you don't own.

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": "jira-connection",
  "schemaVersion": "1.0",
  "scope": "environment",
  "externalId": "myExternalId",
  "value": {
    "autoMonitoring": true
  },
  "insertPosition": "first",
  "insertNeighbor": "Y2ktaGdyb3VwLTEyMythZjhjOThlOS0wN2I0LTMyMGEtOTQzNi02NTEyMmVlNWY4NGQ="
}

Response

{
  "objectId": "Y2ktaGdyb3VwLTEyMythZjhjOThlOS0wN2I0LTMyMGEtOTQzNi02NTEyMmVlNWY4NGQ=",
  "version": "Y2ktaGdyb3VwLTEyMythZjhjOThlOS0wN2I0LTMyMGEtOTQzNi02NTEyMmVlNWY4NGQ="
}