curl -X DELETE "https://api.telzino.com/v1/custom-voices/ROW_ID?organizationId=ORG_UUID" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{ "success": true }
{
"error": "Voice is in use by one or more agents. Reassign them before deleting.",
"agents": [{ "id": "agent-uuid", "name": "Front Desk" }]
}
Custom Voices
Delete Custom Voice
Delete a cloned voice (blocked while in use)
DELETE
/
v1
/
custom-voices
/
{voiceId}
curl -X DELETE "https://api.telzino.com/v1/custom-voices/ROW_ID?organizationId=ORG_UUID" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{ "success": true }
{
"error": "Voice is in use by one or more agents. Reassign them before deleting.",
"agents": [{ "id": "agent-uuid", "name": "Front Desk" }]
}
Deletes a custom (cloned) voice from the organization and from Cartesia.
Deletion is blocked while any agent in the organization still uses the voice —
reassign those agents first.
Path Parameters
string
required
Query Parameters
string
required
The organization that owns the voice.
curl -X DELETE "https://api.telzino.com/v1/custom-voices/ROW_ID?organizationId=ORG_UUID" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
{ "success": true }
{
"error": "Voice is in use by one or more agents. Reassign them before deleting.",
"agents": [{ "id": "agent-uuid", "name": "Front Desk" }]
}
Errors
| Status | Meaning |
|---|---|
400 | organizationId is missing |
404 | Organization or voice not found |
409 | Voice is in use; response includes the using agents |