Try it free

Get a schema version file

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Retrieve a schema file for an Extension 2.0 schema version in Dynatrace with the Extensions API by schema version and file name.

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

Overview

You provide the schema version and file name in the path. Dynatrace returns the requested schema file for that Extension 2.0 schema version.

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

ParameterTypeDescriptionInRequired
schema-versionstring

The version of the schema.

pathRequired
file-namestring

The name of the schema file.

pathRequired

Response

Response codes

CodeTypeDescription
200JsonNode

Success.

4XXErrorEnvelope

Client error.

5XXErrorEnvelope

Server error.

Response body objects

The JsonNode object

The monitoring configuration

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

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