Manage Dynatrace settings objects with the Settings API: create, update, list, and delete objects, and check effective values, history, and permissions.
Use the @dynatrace-sdk/client-settings SDK client instead of calling this API directly — it handles authentication, typing, and the environment URL for you. This REST reference is for external and automation use.
Manage Dynatrace settings through a schema-driven API for storing, querying, and maintaining configuration objects.
Create, retrieve, update, delete, reorder, and inspect settings objects. These endpoints also help you resolve effective settings values so you can understand how configuration is applied.
Query and update permissions for settings objects, grant or revoke access for specific users and groups, and change ownership when needed. These endpoints support the security and governance workflows around shared configuration.
Retrieve revision history for settings objects to inspect how configuration changed over time. This helps with auditing, troubleshooting, and understanding previous updates.
Discover and retrieve schema definitions that describe available settings types and their structure. These endpoints help clients understand which properties are supported and how settings objects must be shaped.
Use helper endpoints for validation, default generation, and value summaries during schema-based editing workflows. These operations are intended to support guided and interactive settings editors.
Platform API endpoints use Platform token and OAuth client authentication. Attach a platform token or OAuth access token to the Authorization HTTP header using the Bearer scheme.
--header 'Authorization: Bearer <platform-token-or-oauth-access-token>'
For details, see Tokens and authentication and Platform tokens.
POST /objects/{object-id}:change-owner)GET /objects/{object-id}/permissions)POST /objects/{object-id}/permissions)GET /objects/{object-id}/permissions/{accessor-type}/{accessor-id})PUT /objects/{object-id}/permissions/{accessor-type}/{accessor-id})DELETE /objects/{object-id}/permissions/{accessor-type}/{accessor-id})GET /objects/{object-id}/permissions/all-users)PUT /objects/{object-id}/permissions/all-users)DELETE /objects/{object-id}/permissions/all-users)GET /objects/{object-id})PUT /objects/{object-id})DELETE /objects/{object-id})GET /objects)POST /objects)POST /objects:reorder)GET /effective-values)POST /effective-permissions:resolve)GET /history)GET /schemas)GET /schemas/{schema-id})GET /values/{schema-id}/default)POST /values/{schema-id}:summarize)POST /values/{schema-id}:validate-property)POST /values/{schema-id}:validate-container)