Extensions API - PUT global configuration

Updates the global configuration of the specified OneAgent or JMX extension.

The request produces an application/json payload.

Early Adopter

This request is an Early Adopter release and may be changed in non-compatible way.

  • Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/extensions/{id}/global
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/config/v1/extensions/{id}/global


To execute this request, you need the Write configuration (WriteConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.


Parameter Type Description In Required
id string

The ID of the extension to be updated.

path required
body GlobalExtensionConfiguration

The JSON body of the request. Contains updated configuration of the extension.

body optional

The GlobalExtensionConfiguration object

Global Configuration of OneAgent and JMX extension

Element Type Description Required
extensionId string

The ID of the extension.

enabled boolean

The extension is enabled (true) or disabled (false).

infraOnlyEnabled boolean

The plugin is enabled (true) or disabled (false) globally for hosts in infrastructure-only monitoring mode

properties object

The list of configuration parameters.

Each parameter is a key-value pair.


Response format

A successful request doesn't return any content.