curl -X DELETE "https://api.contactship.ai/v1/contacts/c1d2e3f4-a5b6-7890-cdef-123456789012/tags/c1b2c3d4-e5f6-4890-abcd-ef1234567890" \
-H "x-api-key: your-api-key"
const contactId = 'c1d2e3f4-a5b6-7890-cdef-123456789012';
const tagId = 'c1b2c3d4-e5f6-4890-abcd-ef1234567890';
const response = await fetch(
`https://api.contactship.ai/v1/contacts/${contactId}/tags/${tagId}`,
{
method: 'DELETE',
headers: { 'x-api-key': 'your-api-key' },
}
);
const { data: success } = await response.json(); // true
import requests
contact_id = 'c1d2e3f4-a5b6-7890-cdef-123456789012'
tag_id = 'c1b2c3d4-e5f6-4890-abcd-ef1234567890'
response = requests.delete(
f'https://api.contactship.ai/v1/contacts/{contact_id}/tags/{tag_id}',
headers={'x-api-key': 'your-api-key'},
)
print(response.json()["data"]) # True
{
"statusCode": 200,
"data": true
}
Contactos
Remove Tag from Contact
Remove a tag assignment from a contact
DELETE
/
v1
/
contacts
/
{contactId}
/
tags
/
{tagId}
curl -X DELETE "https://api.contactship.ai/v1/contacts/c1d2e3f4-a5b6-7890-cdef-123456789012/tags/c1b2c3d4-e5f6-4890-abcd-ef1234567890" \
-H "x-api-key: your-api-key"
const contactId = 'c1d2e3f4-a5b6-7890-cdef-123456789012';
const tagId = 'c1b2c3d4-e5f6-4890-abcd-ef1234567890';
const response = await fetch(
`https://api.contactship.ai/v1/contacts/${contactId}/tags/${tagId}`,
{
method: 'DELETE',
headers: { 'x-api-key': 'your-api-key' },
}
);
const { data: success } = await response.json(); // true
import requests
contact_id = 'c1d2e3f4-a5b6-7890-cdef-123456789012'
tag_id = 'c1b2c3d4-e5f6-4890-abcd-ef1234567890'
response = requests.delete(
f'https://api.contactship.ai/v1/contacts/{contact_id}/tags/{tag_id}',
headers={'x-api-key': 'your-api-key'},
)
print(response.json()["data"]) # True
{
"statusCode": 200,
"data": true
}
Removes a tag from a contact. The tag itself is not deleted — only the assignment is removed.
Headers
string
requerido
Your API key for authentication. Found in your dashboard under API settings.
Path Parameters
string
requerido
The UUID of the contact.
string
requerido
The UUID of the tag to remove.
Response
Returns{ "statusCode": 200, "data": true } on successful removal.
Error Codes
401 Unauthorized— Invalid or missing API key404 Not Found— Contact, tag, or assignment not found500 Internal Server Error— Server-side error
Code Examples
curl -X DELETE "https://api.contactship.ai/v1/contacts/c1d2e3f4-a5b6-7890-cdef-123456789012/tags/c1b2c3d4-e5f6-4890-abcd-ef1234567890" \
-H "x-api-key: your-api-key"
const contactId = 'c1d2e3f4-a5b6-7890-cdef-123456789012';
const tagId = 'c1b2c3d4-e5f6-4890-abcd-ef1234567890';
const response = await fetch(
`https://api.contactship.ai/v1/contacts/${contactId}/tags/${tagId}`,
{
method: 'DELETE',
headers: { 'x-api-key': 'your-api-key' },
}
);
const { data: success } = await response.json(); // true
import requests
contact_id = 'c1d2e3f4-a5b6-7890-cdef-123456789012'
tag_id = 'c1b2c3d4-e5f6-4890-abcd-ef1234567890'
response = requests.delete(
f'https://api.contactship.ai/v1/contacts/{contact_id}/tags/{tag_id}',
headers={'x-api-key': 'your-api-key'},
)
print(response.json()["data"]) # True
{
"statusCode": 200,
"data": true
}