Skip to main content
GET
https://api.telzino.com
/
v1
/
agents
# List all agents
curl "https://api.telzino.com/v1/agents?page=1&limit=50" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Filter by organization
curl "https://api.telzino.com/v1/agents?organization_id=123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "organization_id": "987fcdeb-51a2-3bc4-d567-890123456789",
      "name": "Customer Support Agent",
      "description": "Handles customer inquiries",
      "greeting_message": "Hello! How can I help you today?",
      "system_prompt": "You are a helpful customer support agent...",
      "agent_type": "simple",
      "model": "gpt-4o",
      "voice_model": "gpt-4o-realtime-preview",
      "stt_model": "deepgram",
      "tts_model": "cartesia",
      "voice_settings": {"voice_id": "alloy", "speed": 1.0},
      "config": {"enable_recording": true},
      "extensions": {},
      "integrations": {},
      "transfer_enabled": false,
      "status": "active",
      "is_active": true,
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "456e7890-e89b-12d3-a456-426614174001",
      "organization_id": "987fcdeb-51a2-3bc4-d567-890123456789",
      "name": "Appointment Scheduler",
      "description": "Schedules appointments via Google Calendar",
      "greeting_message": "Hi! I can help you schedule an appointment.",
      "system_prompt": "You are an appointment scheduling assistant...",
      "agent_type": "advanced",
      "model": "gpt-4o",
      "voice_model": "gpt-4o-realtime-preview",
      "stt_model": "deepgram",
      "tts_model": "minimax",
      "voice_settings": {"voice_id": "English_radiant_girl"},
      "config": {"user_timezone": "America/New_York"},
      "extensions": {},
      "integrations": {"google_calendar": {"enabled": true}},
      "transfer_enabled": true,
      "status": "active",
      "is_active": true,
      "created_at": "2024-01-10T08:00:00Z",
      "updated_at": "2024-01-14T16:45:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 150,
    "totalPages": 3,
    "hasNext": true,
    "hasPrev": false
  }
}

​
Query Parameters

​
organization_id
string
Filter by organization ID (UUID format). Only returns agents belonging to this organization.
​
page
integer
default:"1"
Page number for pagination (1-indexed)
​
limit
integer
default:"50"
Number of items per page (max 100)
# List all agents
curl "https://api.telzino.com/v1/agents?page=1&limit=50" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Filter by organization
curl "https://api.telzino.com/v1/agents?organization_id=123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "organization_id": "987fcdeb-51a2-3bc4-d567-890123456789",
      "name": "Customer Support Agent",
      "description": "Handles customer inquiries",
      "greeting_message": "Hello! How can I help you today?",
      "system_prompt": "You are a helpful customer support agent...",
      "agent_type": "simple",
      "model": "gpt-4o",
      "voice_model": "gpt-4o-realtime-preview",
      "stt_model": "deepgram",
      "tts_model": "cartesia",
      "voice_settings": {"voice_id": "alloy", "speed": 1.0},
      "config": {"enable_recording": true},
      "extensions": {},
      "integrations": {},
      "transfer_enabled": false,
      "status": "active",
      "is_active": true,
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "456e7890-e89b-12d3-a456-426614174001",
      "organization_id": "987fcdeb-51a2-3bc4-d567-890123456789",
      "name": "Appointment Scheduler",
      "description": "Schedules appointments via Google Calendar",
      "greeting_message": "Hi! I can help you schedule an appointment.",
      "system_prompt": "You are an appointment scheduling assistant...",
      "agent_type": "advanced",
      "model": "gpt-4o",
      "voice_model": "gpt-4o-realtime-preview",
      "stt_model": "deepgram",
      "tts_model": "minimax",
      "voice_settings": {"voice_id": "English_radiant_girl"},
      "config": {"user_timezone": "America/New_York"},
      "extensions": {},
      "integrations": {"google_calendar": {"enabled": true}},
      "transfer_enabled": true,
      "status": "active",
      "is_active": true,
      "created_at": "2024-01-10T08:00:00Z",
      "updated_at": "2024-01-14T16:45:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 150,
    "totalPages": 3,
    "hasNext": true,
    "hasPrev": false
  }
}

​
Agent Object Fields

FieldTypeDescription
idstringUnique agent identifier (UUID)
organization_idstringOrganization the agent belongs to
namestringDisplay name
descriptionstringAgent description
greeting_messagestringInitial message when call starts
system_promptstringAI behavior instructions
agent_typestringConfiguration type: simple, advanced, custom
modelstringLLM model (e.g., gpt-4o)
voice_modelstringVoice model
stt_modelstringSpeech-to-text model
tts_modelstringText-to-speech model: cartesia, minimax, deepgram
voice_settingsobjectVoice configuration (varies by TTS model)
configobjectGeneral configuration
extensionsobjectWebhooks and MCP server configs
integrationsobjectThird-party integrations (calendar, modmed)
transfer_enabledbooleanWhether call transfer is enabled
statusstringStatus: active, inactive, cancelled, pending
is_activebooleanWhether agent is currently active
created_atdatetimeCreation timestamp
updated_atdatetimeLast update timestamp

​
Pagination

Responses include pagination metadata to help navigate through large result sets:
FieldTypeDescription
pageintegerCurrent page number
limitintegerItems per page
totalintegerTotal number of agents
totalPagesintegerTotal number of pages
hasNextbooleanWhether there are more pages
hasPrevbooleanWhether there are previous pages