• Home
  • Dynatrace API
  • Environment
  • Extensions 2.0
  • Extensions
  • POST an extension file

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.

POSTManagedDynatrace for Governmenthttps://{your-domain}/e/{your-environment-id}/api/v2/extensions
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/extensions
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions

Authentication

To execute this request, you need an access token with extensions.write scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
file.zip fileExtension 2.0 package file (*.zip) to be uploaded. Must contain only extension zip and .zip.sig files.bodyrequired

Response

Response codes

CodeTypeDescription
200ExtensionUploadResponseDto

The extension is valid

201ExtensionUploadResponseDto

Success. The extension 2.0 has been uploaded.

400ErrorEnvelope

Failed. The input file is invalid.

409ErrorEnvelope

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

Response body objects

The ExtensionUploadResponseDto object

ElementTypeDescription
extensionNamestring

Extension name

versionstring

Extension version

authorAuthorDto

Extension author

dataSourcesstring[]

Data sources that extension uses to gather data

variablesstring[]

Custom variables used in extension configuration

featureSetsstring[]

Available feature sets

featureSetsDetailsobject

Details of feature sets

minDynatraceVersionstring

Minimal Dynatrace version that works with the extension

minEECVersionstring

Minimal Extension Execution Controller version that works with the extension

fileHashstring

SHA-256 hash of uploaded Extension file

assetsInfoAssetInfo[]

Information about extension assets included

The AuthorDto object

Extension author

ElementTypeDescription
namestring

Author name

The FeatureSetDetails object

Additional information about a Feature Set

ElementTypeDescription
metricsMetricDto[]

Feature set metrics

The MetricDto object

Metric gathered by an extension

ElementTypeDescription
keystring

Metric key

metadataMetricMetadataDto

Metric metadata

The MetricMetadataDto object

Metric metadata

ElementTypeDescription
displayNamestring

The name of the metric in the user interface

descriptionstring

A short description of the metric

unitstring

The unit of the metric

The AssetInfo object

Assets types and its count

ElementTypeDescription
assetTypestring-
countinteger-

Response body JSON model

json
{ "extensionName": "string", "version": "1.2.3", "author": { "name": "string" }, "dataSources": [ "string" ], "variables": [ "string" ], "featureSets": [ "string" ], "featureSetsDetails": {}, "minDynatraceVersion": "string", "minEECVersion": "string", "fileHash": "string", "assetsInfo": [ { "assetType": "string", "count": 1 } ] }
Related topics
  • Extensions

    Learn about the extensions framework offered by Dynatrace.