Skip to main content

​
Endpoint

DELETE /api/user/tags/:id
Permanently deletes a tag. You can only delete tags that belong to your account.
This action is irreversible. The tag will be removed from all files that use it.

​
Authentication

Requires authentication via API token or session cookie.

​
Path parameters

​
id
string
required
The tag ID to delete

​
Response

Returns a success confirmation.
​
success
boolean
Always true when deletion is successful

​
Example

curl -X DELETE https://your-zipline.com/api/user/tags/cld1234567890 \
  -H "Authorization: YOUR_API_TOKEN"

​
Response

{
  "success": true
}

​
Errors

​
404
error
Not found - Tag does not exist or doesn’t belong to your account
​
401
error
Unauthorized - Invalid or missing authentication token

​
Notes

  • Deleting a tag removes it from all files that were tagged with it
  • This operation cannot be undone
  • Consider exporting your data before deleting important tags

Build docs developers (and LLMs) love

Get started for freeTalk to us