Try it free

List monitoring configurations

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

List monitoring configurations for an Extension 2.0 in Dynatrace with the Extensions 2.0 API, and page or filter the results.

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

Overview

You provide the extension-name path parameter and can use page-size, page-key, and filter to control the monitoring configurations returned. The operation returns a success response with the configuration list.

Authentication

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

Parameters

ParameterTypeDescriptionInRequired
page-sizeinteger

The amount of monitoring configurations in a single response payload.

The maximal allowed page size is 500.

If not set, 20 is used.

queryOptional
page-keystring

The cursor for the next page of results. You can find it in the next-page-key field of the previous response.

The first page is always returned if you don't specify the page-key query parameter.

When the page-key is set to obtain subsequent pages, you must omit all other query parameters.

queryOptional
extension-namestring

The name of the requested Extension 2.0.

pathRequired
filterstring

The filter parameter, as explained here.

Filtering is supported on the following fields:

  • version
  • active or enabled (both keywords are supported and interchangeable)
  • description
  • activationContext
queryOptional

Response

Response codes

CodeTypeDescription
200ExtensionMonitoringConfigurationList

Success.

4XXErrorEnvelope

Client error.

5XXErrorEnvelope

Server error.

Response body objects

The ExtensionMonitoringConfigurationList object

ElementTypeDescription
itemsExtensionMonitoringConfiguration[]

A list of extension monitoring configurations.

nextPageKeystring

The cursor for the next page of results. Has the value of null on the last page.

Use it in the page-key query parameter to obtain subsequent pages of the result.

pageSizeinteger

The number of entries per page.

totalCountinteger-

The ExtensionMonitoringConfiguration object

A list of extension monitoring configurations.

ElementTypeDescription
modificationInfoModificationInfo

Audit information about the creation and modification of this resource

objectIdstring

Configuration id

scopestring

Configuration scope

valueobject

Configuration

The ModificationInfo object

Audit information about the creation and modification of this resource

ElementTypeDescription
createdBystring

User who created the configuration

createdTimestring

Timestamp when the resource was last modified in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

lastModifiedBystring

User who last modified the configuration

lastModifiedTimestring

Timestamp when the resource was last modified in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

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

{
"items": [
{
"modificationInfo": {
"createdBy": "string",
"createdTime": "string",
"lastModifiedBy": "string",
"lastModifiedTime": "string"
},
"objectId": "string",
"scope": "string",
"value": {}
}
],
"nextPageKey": "AQAAABQBAAAABQ==",
"pageSize": 1,
"totalCount": 1
}
{
"error": {
"code": 1,
"details": {
"constraintViolations": [
{
"location": "string",
"message": "string",
"parameterLocation": "HEADER",
"path": "string"
}
]
},
"message": "string"
}
}
Related tags
Platform APIDynatrace PlatformInfrastructure Observability