Extensions API

Latest Dynatrace
Reference
Published Oct 13, 2026

Discover Dynatrace Extensions 2.0 API to list Java processes for JMX and PMI metrics, upload, install, and manage extension versions.

Building a Dynatrace app?

Use the @dynatrace-sdk/client-extensions-v2 SDK client instead of calling this API directly — it handles authentication, typing, and the environment URL for you. This REST reference is for external and automation use.

Overview

Dynatrace Extensions API provides access to Extensions 2.0 resources in your environment, letting you discover, upload, install, and inspect extensions that extend monitoring coverage. It also helps you identify Java processes available for JMX or PMI metric collection and retrieve their details, which supports configuring custom metric collection for specific applications. Typical usage includes automating extension lifecycle tasks, checking what is already available in the environment, and gathering the process information needed to enable or troubleshoot extension-based monitoring.

Authentication

Platform API endpoints use Platform token and OAuth client authentication. Attach a platform token or OAuth access token to the Authorization HTTP header using the Bearer scheme.

--header 'Authorization: Bearer <platform-token-or-oauth-access-token>'

For details, see Tokens and authentication and Platform tokens.

Endpoints

List JMX processes (GET /discovery/jmx/processes) Early Access
Get a JMX process (GET /discovery/jmx/processes/{process-id}) Early Access
List PMI processes (GET /discovery/pmi/processes) Early Access
Get a PMI process (GET /discovery/pmi/processes/{process-id}) Early Access
List Extensions 2.0 (GET /extensions)
Upload an extension (POST /extensions)
List Extension 2.0 versions (GET /extensions/{extension-name})
Install an Extension 2.0 (POST /extensions/{extension-name})
Get the active environment configuration for an extension (GET /extensions/{extension-name}/environment-configuration)
Activate an environment configuration (POST /extensions/{extension-name}/environment-configuration)
Update the active environment configuration (PUT /extensions/{extension-name}/environment-configuration)
Deactivate the environment configuration (DELETE /extensions/{extension-name}/environment-configuration)
Get an alert template (GET /extensions/{extension-name}/environment-configuration/alert-templates/{alert-template-id})
List monitoring configurations (GET /extensions/{extension-name}/monitoring-configurations)
Create a monitoring configuration (POST /extensions/{extension-name}/monitoring-configurations)
List monitoring configuration statuses (GET /extensions/{extension-name}/monitoring-configurations/statuses)
Get a monitoring configuration (GET /extensions/{extension-name}/monitoring-configurations/{configuration-id})
Update a monitoring configuration (PUT /extensions/{extension-name}/monitoring-configurations/{configuration-id})
Delete a monitoring configuration (DELETE /extensions/{extension-name}/monitoring-configurations/{configuration-id})
Execute monitoring configuration actions (PUT /extensions/{extension-name}/monitoring-configurations/{configuration-id}/actions)
List monitoring configuration audit logs (GET /extensions/{extension-name}/monitoring-configurations/{configuration-id}/audit)
Get a monitoring configuration status (GET /extensions/{extension-name}/monitoring-configurations/{configuration-id}/status)
Get an extension version (GET /extensions/{extension-name}/{extension-version})
Delete an extension version (DELETE /extensions/{extension-name}/{extension-version})
List ActiveGate groups for an extension (GET /extensions/{extension-name}/{extension-version}/active-gate-groups)
Get an extension configuration schema (GET /extensions/{extension-name}/{extension-version}/schema)
Validate an extension (POST /extensions:validate)
List schema versions (GET /schemas)
List schema version files (GET /schemas/{schema-version})
Get a schema version file (GET /schemas/{schema-version}/{file-name})