Try it free

Delete an ActiveGate token

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Delete an ActiveGate token from your Dynatrace environment by its ID with the Fleet Management API, for example when you rotate or revoke access.

DELETESaaShttps://{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 delete one ActiveGate token. A 204 response without a body confirms the deletion, and ActiveGates can no longer use the token. Typical usage is revoking a token that is no longer needed or was exposed, after you created a replacement.

Authentication

To execute this request, you need a platform token or OAuth access token with fleet-management:activegate.tokens:write scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
idstring

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

pathRequired

Response

Response codes

CodeTypeDescription
204-

Success. Response doesn't have a body.

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

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

{
"error": {
"code": 1,
"constraintViolations": [
{
"location": "string",
"message": "string",
"parameterLocation": "HEADER",
"path": "string"
}
],
"message": "string"
}
}
Related tags
Platform APIDynatrace Platform