Extensions 2.0 API - POST an extension file

Uploads an Extensions 2.0 extension file to your Dynatrace environment.

The request consumes a multipart/form-data payload and produces an application/json payload.

  • Managed https://{your-domain}/e/{your-environment-id}/api/v2/extensions
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/extensions
  • Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions


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



Parameter Type Description In Required
file .zip file Extension 2.0 package file (*.zip) to be uploaded. Must contain only extension zip and .zip.sig files. body required


Response codes

Code Description

The extension is valid


Success. The extension 2.0 has been uploaded.


Failed. The input file is invalid.


Upload not possible yet, please try again in a few seconds.

Response body

The Extension object

Element Type Description
extensionName string

Extension name

version string

Extension version

author AuthorDto
dataSources string[]

Data sources that extension uses to gather data

variables string[]

Custom variables used in extension configuration

featureSets string[]

Available feature sets

featureSetsDetails object

Details of feature sets

minDynatraceVersion string

Minimal Dynatrace version that works with the extension

fileHash string

SHA-256 hash of uploaded Extension file

The FeatureSetDetails object

Additional information about a Feature Set

Element Type Description
metrics MetricDto[]

Feature set metrics

The MetricDto object

Metric gathered by an extension

Element Type Description
key string

Metric key

The AuthorDto object

Extension author

Element Type Description
name string

Author name