Try it free

List schema versions

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

List Extension 2.0 schema versions in Dynatrace with the Extensions API so you can see which versions are available in the environment.

GETSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/extensions/v2/schemas

Overview

You list all schema versions of Extension 2.0 available in the environment. The operation returns 200 with the schema version list.

Authentication

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

Parameters

The request doesn't provide any configurable parameters.

Response

Response codes

CodeTypeDescription
200SchemaVersionList

Success.

4XXErrorEnvelope

Client error.

5XXErrorEnvelope

Server error.

Response body objects

The SchemaVersionList object

A list of available schema versions.

ElementTypeDescription
itemsstring[]

A list of schema versions.

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
codeinteger

The HTTP status code.

detailsErrorDetails

The error details.

messagestring

The error message.

The ErrorDetails object

The error details.

ElementTypeDescription
constraintViolationsConstraintViolation[]

A list of constraint violations.

The ConstraintViolation object

A list of constraint violations.

ElementTypeDescription
locationstring-
messagestring-
parameterLocationstring-
The element can hold these values
  • HEADER
  • PATH
  • PAYLOAD_BODY
  • QUERY
pathstring-

Response body JSON models

{
"items": [
"1.2.3"
]
}
{
"error": {
"code": 1,
"details": {
"constraintViolations": [
{
"location": "string",
"message": "string",
"parameterLocation": "HEADER",
"path": "string"
}
]
},
"message": "string"
}
}
Related tags
Platform APIDynatrace PlatformInfrastructure Observability