List settings schemas

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

List the settings schemas available in your Dynatrace environment with the Settings API, with additional fields on request, to find schemas to work with.

Overview

You use this operation to list every settings schema available in your environment, and the add-fields query parameter to include fields beyond the default set. A 200 response returns the schemas. Typical usage is discovering a schema ID before you read or write its settings objects.

Authentication

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

Parameters

Response

{
  "items": [
    {
      "displayName": "Built-in container monitoring rules",
      "maturity": "GENERAL_AVAILABILITY",
      "latestSchemaVersion": "1.4.2",
      "schemaVersions": [
        "1.4.2"
      ],
      "schemaId": "builtin:container.built-in-monitoring-rule",
      "multiObject": true,
      "ordered": false,
      "ownerBasedAccessControl": true
    }
  ],
  "totalCount": 1
}