Deleting a tag

A tag can be deleted from your collection by sending a DELETE request to its API URL: https://api.rebrandly.com/v1/tags/:id, 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 name

Description

id

Unique identifier of the tag you want to permanently delete

Permanently deleting a single tag
$ curl 'https://api.rebrandly.com/v1/tags/fffa4cc5b6ee45d6g7897b06ac2d16af' \
-X DELETE \
-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 Status

Error type

Description

404

404 - Not found

Given id does not correspond to any existing tag


Did this page help you?