Rebrandly for Developers

Use our API to create, track and share custom short links that incorporate your brand domain name.

Get Started

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 name


Unique 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 Status
Error type


Given id does not correspond to any existing tag

Deleting a tag

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.