Deletes the specified Dynatrace API authentication token.
| DELETE | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/v2/apiTokens/{id} |
| DELETE | Environment and Cluster ActiveGate (default port 9999) | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/apiTokens/{id} |
To execute this request, you need an access token with apiTokens.write scope.
One of the following permissions is required for personal access tokens:
environment:roles:viewerapi-tokens:tokens:writeTo learn how to obtain and use it, see Personal access tokens.
Required scope: api-tokens:tokens:write
To learn how to obtain and use it, see Platform tokens or OAuth clients.
| 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 |
| Code | Type | Description |
|---|---|---|
| 204 | - | Success. Response doesn't have a body. |
| 400 | Error | Failed. You can't delete the token you're using for authentication of the request. |
| 404 | - | Failed. The requested resource doesn't exist. |
| 4XX | Error | Client side error. |
| 5XX | Error | Server side error. |
ErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Error | - |
Error object| Element | Type | Description |
|---|---|---|
| code | integer | The HTTP status code |
| constraintViolations | Constraint | A list of constraint violations |
| message | string | The error message |
ConstraintViolation objectA list of constraint violations
| Element | Type | Description |
|---|---|---|
| location | string | - |
| message | string | - |
| parameterLocation | string | -The element can hold these values
|
| path | string | - |
{"error": {"code": 1,"constraintViolations": [{"location": "string","message": "string","parameterLocation": "HEADER","path": "string"}],"message": "string"}}