Docs - AI phone agents for SMB

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" }]
}

DELETE

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

The voice id returned by Create / List (the Cartesia voice id). The internal custom_voices row id is also accepted.

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`

API Reference

Agents

Places

MCP

Knowledge Bases

Guardrails

Email Servers

Voices

Custom Voices

STT Providers

LLM Models

Call Logs

Outbound Calls

Metrics

Reports

Resellers

Organizations

Sessions

Billing

Payments

Delete Custom Voice

Path Parameters

Query Parameters

Response

Errors

​Path Parameters

​Query Parameters

​Response

​Errors

Path Parameters

Query Parameters

Response

Errors