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 nameDescription
idUnique 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 StatusError typeDescription
404404 - Not foundGiven id does not correspond to any existing tag

Did this page help you?
// Bulk plan CTA banner: requested by Alison to promote the high-volume pricing plan. Injected in Footer HTML per ReadMe convention, but renderd at the top of the viewport via the fixed-position CSS above.
Sending 250K+ links a year? You qualify for a better rate. See high-volume pricing