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 |
Updated 5 months ago