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
Path Parameters
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
}
