Try it free

Update the active environment configuration

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Update the active environment configuration version for an Extension 2.0 in Dynatrace with the Extensions 2.0 API using the extension name and version.

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

Overview

You provide the extension-name path parameter and a version field in the request body to update the active environment configuration. The operation returns a success response when the configuration is updated.

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
bodyExtensionEnvironmentConfigurationVersion

The version of the requested environment configuration.

bodyRequired

Request body objects

The ExtensionEnvironmentConfigurationVersion object

ElementTypeDescriptionRequired
versionstring

Extension version

Required

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

{
"version": "1.2.3"
}

Response

Response codes

CodeTypeDescription
200ExtensionEnvironmentConfigurationVersion

Success. Environment configuration updated.

4XXErrorEnvelope

Client error.

5XXErrorEnvelope

Server error.

Response body objects

The ExtensionEnvironmentConfigurationVersion object

ElementTypeDescription
versionstring

Extension version

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

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