Try it free

Get an ActiveGate token

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Get the metadata of an ActiveGate token in Dynatrace by its ID with the Fleet Management API; the token secret itself is never exposed in the response.

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

Overview

You use the id path parameter, the token identifier made of its prefix and public part, to read the metadata of one ActiveGate token. The response doesn't expose the token secret, which is only returned once when the token is created. Typical usage is checking a token's owner or expiration date before you rotate or delete it.

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
idstring

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

pathRequired

Response

Response codes

CodeTypeDescription
200ActiveGateToken

Success. The response contains the metadata of the token.

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

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

{
"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
}
{
"error": {
"code": 1,
"constraintViolations": [
{
"location": "string",
"message": "string",
"parameterLocation": "HEADER",
"path": "string"
}
],
"message": "string"
}
}
Related tags
Platform APIDynatrace Platform