curl -X POST "https://api.telzino.com/v1/organizations/org-abc12345-e89b-12d3-a456-426614174000/agents" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "Support Bot",
"description": "Handles support tickets",
"external_id": "external-agent-123"
}'
const organizationId = 'org-abc12345-e89b-12d3-a456-426614174000';
const response = await fetch(
`https://api.telzino.com/v1/organizations/${organizationId}/agents`,
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
title: 'Support Bot',
description: 'Handles support tickets',
external_id: 'external-agent-123'
})
}
);
const { id } = await response.json();
import requests
organization_id = 'org-abc12345-e89b-12d3-a456-426614174000'
response = requests.post(
f'https://api.telzino.com/v1/organizations/{organization_id}/agents',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'},
json={
'title': 'Support Bot',
'description': 'Handles support tickets',
'external_id': 'external-agent-123'
}
)
agent = response.json()
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
{
"error": "Invalid request data",
"details": [
{
"code": "too_small",
"minimum": 1,
"type": "string",
"inclusive": true,
"message": "Title is required",
"path": ["title"]
}
]
}
{
"error": "Organization not found"
}
{
"error": "Failed to create agent"
}
Organizations
Create Agent in Organization
Creates a new agent scoped to the specified organization
POST
/
v1
/
organizations
/
{organization_id}
/
agents
curl -X POST "https://api.telzino.com/v1/organizations/org-abc12345-e89b-12d3-a456-426614174000/agents" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "Support Bot",
"description": "Handles support tickets",
"external_id": "external-agent-123"
}'
const organizationId = 'org-abc12345-e89b-12d3-a456-426614174000';
const response = await fetch(
`https://api.telzino.com/v1/organizations/${organizationId}/agents`,
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
title: 'Support Bot',
description: 'Handles support tickets',
external_id: 'external-agent-123'
})
}
);
const { id } = await response.json();
import requests
organization_id = 'org-abc12345-e89b-12d3-a456-426614174000'
response = requests.post(
f'https://api.telzino.com/v1/organizations/{organization_id}/agents',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'},
json={
'title': 'Support Bot',
'description': 'Handles support tickets',
'external_id': 'external-agent-123'
}
)
agent = response.json()
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
{
"error": "Invalid request data",
"details": [
{
"code": "too_small",
"minimum": 1,
"type": "string",
"inclusive": true,
"message": "Title is required",
"path": ["title"]
}
]
}
{
"error": "Organization not found"
}
{
"error": "Failed to create agent"
}
Overview
Creates a minimal agent (title, description, external_id) under the given organization. For creating an agent with full configuration (voice, prompts, model, etc.) usePOST /v1/agents instead.
The agent is created with the standard Cartesia voice (Katie – Friendly Fixer) on the sonic-3.5 model. Update the voice later via PUT /v1/agents/{id} or in the dashboard.
Path Parameters
string
required
Organization ID (UUID) to create the agent under
Request Body
string
required
Name of the agent (1–255 characters)
string
Description of what the agent does (max 1000 characters)
string
External identifier for integration with your systems (max 255 characters)
curl -X POST "https://api.telzino.com/v1/organizations/org-abc12345-e89b-12d3-a456-426614174000/agents" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "Support Bot",
"description": "Handles support tickets",
"external_id": "external-agent-123"
}'
const organizationId = 'org-abc12345-e89b-12d3-a456-426614174000';
const response = await fetch(
`https://api.telzino.com/v1/organizations/${organizationId}/agents`,
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
title: 'Support Bot',
description: 'Handles support tickets',
external_id: 'external-agent-123'
})
}
);
const { id } = await response.json();
import requests
organization_id = 'org-abc12345-e89b-12d3-a456-426614174000'
response = requests.post(
f'https://api.telzino.com/v1/organizations/{organization_id}/agents',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'},
json={
'title': 'Support Bot',
'description': 'Handles support tickets',
'external_id': 'external-agent-123'
}
)
agent = response.json()
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
{
"error": "Invalid request data",
"details": [
{
"code": "too_small",
"minimum": 1,
"type": "string",
"inclusive": true,
"message": "Title is required",
"path": ["title"]
}
]
}
{
"error": "Organization not found"
}
{
"error": "Failed to create agent"
}
Response Fields
| Field | Type | Description |
|---|---|---|
id | string (UUID) | ID of the newly created agent |
⌘I
