Try it free

Deactivate the environment configuration

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Deactivate the environment configuration for an Extension 2.0 in Dynatrace with the Extensions 2.0 API and remove the active configuration.

DELETESaaShttps://{your-environment-id}.apps.dynatrace.com/platform/extensions/v2/extensions/{extension-name}/environment-configuration

Overview

You provide the extension-name path parameter to select the Extension 2.0 whose environment configuration you want to deactivate. The operation returns a 204 response and no body.

Authentication

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

Parameters

ParameterTypeDescriptionInRequired
extension-namestring

The name of the requested Extension 2.0.

pathRequired

Response

Response codes

CodeTypeDescription
204-

Success. Environment configuration deactivated. Response doesn't have a body.

4XXErrorEnvelope

Client error.

5XXErrorEnvelope

Server error.

Response body objects

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