ActiveGate tokens API - DELETE a token

Deletes an ActiveGate token.

Early Adopter

This request is an Early Adopter release and may be changed in non-compatible way.

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

Authentication

To execute this request, you need Write ActiveGate tokens (activeGateTokenManagement.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
tokenIdentifier	string	The token to be deleted. You can specify either the ID or the secret of the token.	path	required

Parameter

Type

Description

Required

tokenIdentifier

string

The token to be deleted.

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

path

required

Response

Response codes

Code	Type	Description
204	-	Success. Response doesn't have a body.
400	ErrorEnvelope	Failed. The input is invalid.
404	ErrorEnvelope	Failed. The requested resource doesn't exist.

Example

In this example, the request deletes the token with the ID of dt0g02.xyz789.

The API token is passed in the Authorization header.

Curl

bash
curl --request DELETE \
  --url https://mySampleEnv.live.dynatrace.com//api/v2/activeGateTokens/dt0g02.xyz789 \
  --header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

http
https://mySampleEnv.live.dynatrace.com//api/v2/activeGateTokens/dt0g02.xyz789

Response code

204