Try it free

List ActiveGate tokens

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

List the ActiveGate tokens in your Dynatrace environment with the Fleet Management API, page by page, to review which tokens exist and when they expire.

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

Overview

You use this operation to list the ActiveGate tokens of your environment. The response is paginated: set page-size for the number of tokens per page and pass the nextPageKey from a previous response as page-key to get the next page. The response contains token metadata only, never the token secrets.

Authentication

To execute this request, you need a platform token or OAuth access token with fleet-management:activegate.tokens:read 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 tokens in a single response payload.

The maximal allowed page size is 3000 and the minimum size is 100.

If not set, 100 is used.

queryOptional

Response

Response codes

CodeTypeDescription
200ActiveGateTokenList

Success. The response contains the list of ActiveGate tokens.

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

The ActiveGateTokenList object

A list of ActiveGate tokens.

ElementTypeDescription
activeGateTokensActiveGateToken[]

A list of ActiveGate tokens.

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.

The ActiveGateToken object

Metadata of an ActiveGate token.

ElementTypeDescription
creationDatestring

The token creation date in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z').

expirationDatestring

The token expiration date in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z').

If not set, the token never expires.

idstring

The ActiveGate token identifier, consisting of the prefix and public parts of the token.

lastUsedDatestring

The token last used date in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z').

namestring

The name of the token.

ownerstring

The owner of the token.

seedTokenboolean

The token is a seed token (true) or an individual token (false).

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

{
  "activeGateTokens": [
    {
      "creationDate": "2020-11-22T08:15:30.144Z",
      "expirationDate": "2020-11-24T08:15:30.144Z",
      "id": "dt0g02.4KWZO5EF",
      "lastUsedDate": "2020-11-23T08:15:30.144Z",
      "name": "myToken",
      "owner": "john.smith",
      "seedToken": false
    }
  ],
  "nextPageKey": "AQAAABQBAAAABQ==",
  "pageSize": 100,
  "totalCount": "1000"
}
{
  "error": {
    "code": 1,
    "constraintViolations": [
      {
        "location": "string",
        "message": "string",
        "parameterLocation": "HEADER",
        "path": "string"
      }
    ],
    "message": "string"
  }
}
Related tags
Platform APIDynatrace Platform