ActiveGate tokens API - DELETE a token
Deletes an ActiveGate token.
| DELETE | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/v2/activeGateTokens/{activeGateTokenIdentifier} |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/activeGateTokens/{activeGateTokenIdentifier} | |
| Environment ActiveGateCluster ActiveGate | https://{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
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| activeGateTokenIdentifier | string | The ActiveGate token identifier, consisting of prefix and public part of the token to be deleted. | path | required |
Response
Response codes
| Code | Type | Description |
|---|---|---|
| 204 | - | Success. Response doesn't have a body. |
| 400 | ErrorEnvelope | Failed. The input is invalid. |
| 404 | ErrorEnvelope | Failed. The requested resource doesn't exist. |
| 4XX | ErrorEnvelope | Client side error. |
| 5XX | ErrorEnvelope | 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