Deleting a tag

A tag can be deleted from your collection by sending a DELETE request to its API URL:, where :id is the unique identifier of the tag.
The action is not reversible and will permanently delete your tag, detaching it from all links you have attached it to.

PATH Parameters

Parameter nameDescription
idUnique identifier of the tag you want to permanently delete
Permanently deleting a single tag
$ curl '' \
-H 'Authorization: Bearer YOUR_TOKEN_HERE'
When a tag is deleted, its last object representation is returned (prior to deletion).
  "id": "fffa4cc5b6ee45d6g7897b06ac2d16af",
  "name": "promo",
  "color": "FF0044"

Handling errors

HTTP StatusError typeDescription
404404 - Not foundGiven id does not correspond to any existing tag