API authentication tokens API - DELETE a token

Deletes the specified Dynatrace API authentication token.

  • If you're using a personal access token to authenticate the call, you can delete only your own tokens.
  • If you're using an API token to authenticate the call, you can delete any token.

DELETE
  • Managed https://{your-domain}/e/{your-environment-id}/api/v2/apiTokens/{id}
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/apiTokens/{id}
  • Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v2/apiTokens/{id}

Authentication

To execute this request, you need the Write API tokens (apiTokens.write) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter Type Description In Required
id string

The ID of the token to be deleted.

You can specify either the ID or the secret of the token.

You can't delete the token you're using for authentication of the request.

path required

Response

Response codes

Code Description
204

Success. Response doesn't have a body.

400

Failed. You can't delete the token you're using for authentication of the request.

404

Failed. The requested resource doesn't exist.

Response body

A successful request doesn't return any content.