Hosts API - DELETE tag

This API is deprecated. Use the Monitored entities API instead. You can find more information about switching to the new API in the migration guide.

Deletes the specified custom tag from the specified host. Deletion cannot be undone.

DELETESaaShttps://{your-environment-id}.live.dynatrace.com/api/v1/entity/infrastructure/hosts/{meIdentifier}/tags/{tag}
Environment ActiveGatehttps://{your-activegate-domain}:9999/e/{your-environment-id}/api/v1/entity/infrastructure/hosts/{meIdentifier}/tags/{tag}

Authentication

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

To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter
Type
Description
In
Required
meIdentifier
string

The Dynatrace entity ID of the host.

path
required
tag
string

The tag to be removed.

path
required

Response

Response codes

Code
Type
Description
204
-

Success. The tag of the host has been removed.

400

Failed. The input is invalid.

404
-

Failure. The tag could not be found.

4XX

Client side error.

5XX

Server side error.

Example

In this example, the request deletes the Rack123 tag from the tag009 host, which has the ID of HOST-B7A6F9EE9F366CB5.

The API token is passed in the Authorization header.

Curl

curl -X POST \
  https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/hosts/HOST-B7A6F9EE9F366CB5/tags/Rack123 \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/hosts/HOST-B7A6F9EE9F366CB5/tags/Rack123

Response code

204

Related topics