Saltar al contenido principal
DELETE
/
v1
/
tags
/
{tagId}
curl -X DELETE "https://api.contactship.ai/v1/tags/tag-a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "x-api-key: your-api-key"

true
Permanently deletes a tag. This also removes the tag from all contacts it was assigned to.

​
Headers

​
x-api-key
string
requerido
Your API key for authentication. Found in your dashboard under API settings.

​
Path Parameters

​
tagId
string
requerido
The UUID of the tag to delete.

​
Response

Returns true on successful deletion.

​
Error Codes

  • 401 Unauthorized — Invalid or missing API key
  • 404 Not Found — Tag not found
  • 500 Internal Server Error — Server-side error

​
Code Examples

curl -X DELETE "https://api.contactship.ai/v1/tags/tag-a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "x-api-key: your-api-key"

true