Try it free

Update a monitoring configuration

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Update a monitoring configuration in Dynatrace Extensions 2.0 by extension name and configuration ID, using the supplied value.

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

Overview

You provide the extension name and monitoring configuration ID in the path, then send the value field in the request body to update the configuration. The operation returns a 200 success response.

Authentication

To execute this request, you need a platform token or OAuth access token with extensions:configurations: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
configuration-idstring

The ID of the requested monitoring configuration.

pathRequired
bodyMonitoringConfigurationUpdate

JSON body of the request, containing monitoring configuration parameters. Monitoring configuration scope cannot be updated.

bodyRequired

Request body objects

The MonitoringConfigurationUpdate object

ElementTypeDescriptionRequired
valueJsonNode

The monitoring configuration

Optional

The JsonNode object

The monitoring configuration

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.

{
"value": {}
}

Response

Response codes

CodeTypeDescription
200MonitoringConfigurationResponse

Success.

4XXErrorEnvelope

Client error.

5XXErrorEnvelope

Server error.

Response body objects

The MonitoringConfigurationResponse object

ElementTypeDescription
codeinteger

The HTTP Status code

objectIdstring

The identifier of the new 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

{
"code": 1,
"objectId": "331e416f-9ab7-4694-8408-816026820645"
}
{
"error": {
"code": 1,
"details": {
"constraintViolations": [
{
"location": "string",
"message": "string",
"parameterLocation": "HEADER",
"path": "string"
}
]
},
"message": "string"
}
}
Related tags
Platform APIDynatrace PlatformInfrastructure Observability