• Home
  • Dynatrace API
  • Environment
  • Tokens v2
  • ActiveGate tokens
  • GET a token

ActiveGate tokens API - GET a token

Gets metadata of the ActiveGate token by its ID.

The request produces an application/json payload.

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

Authentication

To execute this request, you need an access token with activeGateTokenManagement.read scope.

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

Parameters

ParameterTypeDescriptionInRequired
activeGateTokenIdentifierstring

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

pathrequired

Response

Response codes

CodeTypeDescription
200ActiveGateToken

Success. The response contains the metadata of the tokens.

400ErrorEnvelope

Failed. The input is invalid.

404ErrorEnvelope

Failed. The requested resource doesn't exist.

Response body objects

The ActiveGateToken object

Metadata of an ActiveGate token.

ElementTypeDescription
idstring

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

namestring

The name of the token.

ownerstring

The owner of the token.

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.

lastUsedDatestring

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

seedTokenboolean

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

activeGateTypestring

The type of the ActiveGate for which the token is valid.

The element can hold these values
  • ENVIRONMENT
  • CLUSTER

Response body JSON model

json
{ "id": "dt0g02.4KWZO5EF", "name": "myToken", "owner": "john.smith", "creationDate": "2020-11-22T08:15:30.144Z", "expirationDate": "2020-11-24T08:15:30.144Z", "lastUsedDate": "2020-11-23T08:15:30.144Z", "seedToken": false, "activeGateType": "ENVIRONMENT" }

Example

In this example, the request retrieves metadata for the token with the ID of dt0g02.abc123.

The API token is passed in the Authorization header.

Curl

bash
curl --request GET \ --url https://mySampleEnv.live.dynatrace.com//api/v2/activeGateTokens/dt0g02.abc123 \ --header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

plaintext
https://mySampleEnv.live.dynatrace.com//api/v2/activeGateTokens/dt0g02.abc123

Response body

json
{ "id": "dt0g02.abc123", "name": "system:installer", "owner": "max.mustermann@company.com", "creationDate": "2021-11-22T11:39:29.797Z", "seedToken": true, "activeGateType": "ENVIRONMENT" }

Response code

200

Related topics
  • Dynatrace ActiveGate

    Understand the basic concepts related to ActiveGate.