Try it free

List ActiveGate installer versions

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

List the available ActiveGate installer versions in Dynatrace with the Fleet Management API, page by page, to choose a version to download.

GETSaaShttps://{your-environment-id}.apps.dynatrace.com/v1/activegate/installer/versions

Overview

You use this operation to list the ActiveGate installer versions available for your environment. The response is paginated: set page-size for the number of versions per page and pass the nextPageKey from a previous response as page-key to get the next page. Typical usage is picking a specific version to download.

Authentication

To execute this request, you need a platform token or OAuth access token with fleet-management:activegates:download scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
page-keystring

The cursor for the next page of results. You can find it in the nextPageKey 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
page-sizeinteger

The amount of ActiveGate Installer versions in a single response payload.

The maximal allowed page size is 1000 and the minimum size is 10.

If not set, 10 is used.

queryOptional

Response

Response codes

CodeTypeDescription
200ActiveGateInstallerVersions

Success

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

The ActiveGateInstallerVersions object

List of available ActiveGate Installer versions

ElementTypeDescription
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.

totalCountstring

The total number of entries in the result.

versionsstring[]

ActiveGate installer versions.

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
codeinteger

The HTTP status code

constraintViolationsConstraintViolation[]

A list of constraint violations

messagestring

The error message

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

{
"nextPageKey": "AQAAABQBAAAABQ==",
"pageSize": 100,
"totalCount": "1000",
"versions": [
"string"
]
}
{
"error": {
"code": 1,
"constraintViolations": [
{
"location": "string",
"message": "string",
"parameterLocation": "HEADER",
"path": "string"
}
],
"message": "string"
}
}
Related tags
Platform APIDynatrace Platform