Delete a tag

DELETE/tags/{tag_id}

Moves the tag to the trash and removes it from every user it is assigned to.

A tag used by an access rule cannot be deleted; the API returns 409 Conflict with the tag_in_use error code.

Replicated tags are read-only and cannot be deleted. Attempts to delete them return 403 Forbidden with the replica_readonly error code.

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Path Parameters

tag_id*string

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/tags/string"
Empty