Try it free

Get the app manifest schema

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Get the JSON schema for app manifests in Dynatrace with the AppEngine Registry API so you can validate manifest structure before installation.

GETSaaShttps://{your-environment-id}.apps.dynatrace.com/registry/v1/app.manifest.schema.json

Overview

You call this operation to retrieve the JSON schema for app manifests. It returns 200 OK with the schema content, which helps you validate app manifest structure in Dynatrace.

Parameters

The request doesn't provide any configurable parameters.

Response

Response codes

CodeTypeDescription
200object

OK

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

The ResponseBody object

The ErrorEnvelope object

Error response for all 4xx and 5xx errors.

ElementTypeDescription
errorError

Contains information for 4xx and 5xx errors.

The Error object

Contains information for 4xx and 5xx errors.

ElementTypeDescription
codeinteger

The HTTP status code

messagestring

The error message

detailsErrorDetails

Contains details for 4xx and 5xx errors.

helpstring

Additional information related to the error

retryAfterSecondsinteger

Seconds to wait until the next retry

The ErrorDetails object

Contains details for 4xx and 5xx errors.

ElementTypeDescription
errorRefstring

Generated unique value for 5xx errors.

traceIdstring

OpenTelemetry trace id of the trace where error occurs.

errorCodestring

An optional error code that contains more detailed error information than the HTTP response code alone.

Possible error codes:

  • MaxNumberOfInstalledAppsExceeded: The app bundle couldn't be uploaded because the max number of apps was exceeded. Learn more: https://dt-url.net/upgrade-license
The element can hold these values
  • MaxNumberOfInstalledAppsExceeded
errorCodePropertiesobject

Additional properties related to the provided error code

constraintViolationsConstraintViolation[]

A list of constraint violations

missingScopesstring[]

The OAuth scopes the authorization token would need to carry for this request.

missingPermissionsstring[]

The IAM permissions the authorization token would need to be granted for this request.

The ConstraintViolation object

Contains information about a constraint violation caused by invalid input.

ElementTypeDescription
pathstring

The path of the property that caused the constraint violation

messagestring

The error message

errorCodestring

An optional error code that contains more detailed error information.

Possible error codes:

  • DependencyVersionIncompatible: The app's manifest contains a dependency with an incompatible version.
  • DependencyUnknown: The app's manifest contains a dependency that is unknown.
The element can hold these values
  • DependencyVersionIncompatible
  • DependencyUnknown
errorCodePropertiesobject

Additional properties related to the provided error code.

Response body JSON models

{
"error": {
"code": 1,
"message": "string",
"details": {
"errorRef": "string",
"traceId": "string",
"errorCode": "MaxNumberOfInstalledAppsExceeded",
"errorCodeProperties": {
"appLimit": "3"
},
"constraintViolations": [
{
"path": "string",
"message": "string",
"errorCode": "DependencyVersionIncompatible",
"errorCodeProperties": {
"dependency": "/platform/storage/query/v1",
"availableVersion": "1.2.0",
"incompatibleVersion": "1.1.0"
}
}
],
"missingScopes": [
"string"
],
"missingPermissions": [
"string"
]
},
"help": "string",
"retryAfterSeconds": 1
}
}
Related tags
Platform APIDynatrace Platform