Skip to main content
GET
/
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-4.1",
      "voice_model": "gpt-4o-realtime-preview",
      "stt_model": "deepgram",
      "tts_model": "cartesia",
      "voice_settings": {"voice_id": "f786b574-daa5-4673-aa0c-cbe3e8534c02", "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-4.1",
      "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.
​
provider
string
Filter by agent provider
​
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-4.1",
      "voice_model": "gpt-4o-realtime-preview",
      "stt_model": "deepgram",
      "tts_model": "cartesia",
      "voice_settings": {"voice_id": "f786b574-daa5-4673-aa0c-cbe3e8534c02", "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-4.1",
      "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, appointment_scheduler
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
extensionsobjecttools (webhooks) and mcp_servers (each item stored in snake_case, e.g. id, connection_name, mcp_endpoint_url (SSE URL vs streamable HTTP URL depending on transport_type), transport_type lowercase sse or http, optional auth_headers, initialization_options, fingerprint, tools with name/description only — see Get Agent)
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