Tokens API - DELETE an existing token
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.
DELETE |
|
Authentication
To execute this request, you need the Token management (TenantTokenManagement
) 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. 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 | 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. |
Response body
A successful request doesn't return any content.
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 abcdefjhij1234567890'
Request URL
https://mySampleEnv.live.dynatrace.com/api/v1/tokens/4e9f128e-04f9-4795-8b7c-3c14a5e885e4
Response code
204