Try it free

Create a monitoring configuration

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Create a monitoring configuration for an Extension 2.0 in Dynatrace with the Extensions API, using the extension name and configuration scope and value.

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

Overview

You provide the extension name in the path and send scope and value in the request body. Dynatrace returns 201 Created when it creates the monitoring configuration.

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
bodyMonitoringConfiguration

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

bodyRequired

Request body objects

The MonitoringConfiguration object

ElementTypeDescriptionRequired
scopestring

The scope this monitoring configuration will be defined for

Required
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.

{
"scope": "HOST-D3A3C5A146830A79",
"value": {}
}

Response

Response codes

CodeTypeDescription
201MonitoringConfigurationResponse

Created.

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