ActiveGate tokens API - DELETE a token

Deletes an ActiveGate token.

DELETESaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/activeGateTokens/{activeGateTokenIdentifier}
Environment ActiveGateCluster ActiveGatehttps://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/activeGateTokens/{activeGateTokenIdentifier}

Authentication

To execute this request, you need an access token with activeGateTokenManagement.write 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 to be deleted.

pathrequired

Response

Response codes

CodeTypeDescription
204-

Success. Response doesn't have a body.

400ErrorEnvelope

Failed. The input is invalid.

404ErrorEnvelope

Failed. The requested resource doesn't exist.

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Example

In this example, the request deletes the token with the ID of dt0g02.xyz789.

The API token is passed in the Authorization header.

Curl

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

Request URL

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

Response code

204