• Home
  • Dynatrace API
  • Environment
  • Extensions 2.0
  • Environment configurations
  • PUT environment configuration

Extensions 2.0 API - PUT environment configuration

Activates the specified version of an Extensions 2.0 extension.

The request consumes and produces an application/json payload.

PUTManaged https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/environmentConfiguration
SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/environmentConfiguration
Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/environmentConfiguration

Authentication

To execute this request, you need an access token with Write extension environment configurations (extensionEnvironment.write) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
extensionNamestring

The name of the requested extension 2.0.

pathrequired
bodyExtensionEnvironmentConfigurationVersion

The version of the requested environment configuration.

bodyrequired

Request body objects

The ExtensionEnvironmentConfigurationVersion object

ElementTypeDescription
versionstring

Extension version

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.

json
{ "version": "1.2.3" }

Response

Response codes

CodeTypeDescription
200ExtensionEnvironmentConfigurationVersion

Success. Environment configuration updated.

400ErrorEnvelope

Failed. The input is invalid.

404ErrorEnvelope

Failed. The requested resource doesn't exist.

Response body objects

The ExtensionEnvironmentConfigurationVersion object

ElementTypeDescription
versionstring

Extension version

Response body JSON model

json
{ "version": "1.2.3" }
Related topics
  • Extensions

    Learn about the extensions framework offered by Dynatrace.