Try it free

App Settings API

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Retrieve, update, and manage Dynatrace App Settings V2 objects, permissions, ownership, and effective settings values across your environment.

Building a Dynatrace app?

Use the @dynatrace-sdk/client-app-settings-v2 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.

Overview

Dynatrace App Settings API lets you retrieve, create, update, and delete persisted app settings objects so you can manage application configuration programmatically. It also exposes the effective settings values and the permissions that apply to a given object, including ownership, user-specific access, and all-users permissions, which helps you control who can view or change settings. Typical usage includes automating configuration workflows, syncing settings across environments, and auditing access before making changes.

Authentication

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.

Endpoints

  • Get a settings object (GET /objects/{object-id})
  • Update a settings object (PUT /objects/{object-id})
  • Delete a settings object (DELETE /objects/{object-id})
  • Transfer ownership of a settings object (POST /objects/{object-id}:transfer-ownership)
  • Get permissions for a settings object (GET /objects/{object-id}/permissions)
  • Add permissions to a settings object (POST /objects/{object-id}/permissions)
  • Get permissions for an accessor on a settings object (GET /objects/{object-id}/permissions/{accessor-type}/{accessor-id})
  • Update permissions for an accessor on a settings object (PUT /objects/{object-id}/permissions/{accessor-type}/{accessor-id})
  • Remove permissions for an accessor on a settings object (DELETE /objects/{object-id}/permissions/{accessor-type}/{accessor-id})
  • Get all-users permissions for a settings object (GET /objects/{object-id}/permissions/all-users)
  • Update all-users permissions for a settings object (PUT /objects/{object-id}/permissions/all-users)
  • Remove all-users permissions from a settings object (DELETE /objects/{object-id}/permissions/all-users)
  • List settings objects (GET /objects)
  • Create a settings object (POST /objects)
  • List effective settings values (GET /effective-values)
  • Resolve effective settings permissions (POST /effective-permissions:resolve)
Related tags
Platform APIDynatrace Platform