Tokens API v1 - DELETE an existing token

This API is deprecated. Use the Access tokens API instead.

Updates the specified Dynatrace API authentication token.

This request enables you to delete any token, including tokens not owned by the user who owns the token used to authenticate the call.

DELETESaaShttps://{your-environment-id}.live.dynatrace.com/api/v1/tokens/{id}
Environment ActiveGatehttps://{your-activegate-domain}:9999/e/{your-environment-id}/api/v1/tokens/{id}

Authentication

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

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. Can either be the public identifier or the secret.

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

path
required

Response

Response codes

Code
Type
Description
204
-

Success

400

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

404

Failed. The requested token has not been found.

4XX

Client side error.

5XX

Server side error.

Example

In this example, the request deletes the token with ID value 4e9f128e-04f9-4795-8b7c-3c14a5e885e4. The response code of 204 indicates that the deletion was successful.

The API token is passed in the Authorization header.

Curl

curl -X DELETE \
  https://mySampleEnv.live.dynatrace.com/api/v1/tokens/4e9f128e-04f9-4795-8b7c-3c14a5e885e4 \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

https://mySampleEnv.live.dynatrace.com/api/v1/tokens/4e9f128e-04f9-4795-8b7c-3c14a5e885e4

Response code

204