Skip to main content
GET
https://api.telzino.com
/
v1
/
agents
/
{agentId}
curl https://api.telzino.com/v1/agents/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 and support requests",
    "greeting_message": "Hello! Thank you for calling. How can I help you today?",
    "system_prompt": "You are a helpful customer support agent for Acme Corp. Be friendly, professional, and concise.",
    "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,
      "user_timezone": "America/New_York",
      "inactivity_timeout": 15
    },
    "extensions": {
      "tools": [
        {
          "type": "webhook",
          "name": "check_order",
          "description": "Check order status",
          "url": "https://api.example.com/orders",
          "method": "GET"
        }
      ]
    },
    "integrations": {
      "google_calendar": {
        "enabled": true,
        "user_timezone": "America/New_York"
      }
    },
    "transfer_enabled": true,
    "status": "active",
    "is_active": true,
    "sip_registration_data": null,
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

Path Parameters

agentId
string
required
The unique identifier of the agent (UUID format)
curl https://api.telzino.com/v1/agents/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 and support requests",
    "greeting_message": "Hello! Thank you for calling. How can I help you today?",
    "system_prompt": "You are a helpful customer support agent for Acme Corp. Be friendly, professional, and concise.",
    "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,
      "user_timezone": "America/New_York",
      "inactivity_timeout": 15
    },
    "extensions": {
      "tools": [
        {
          "type": "webhook",
          "name": "check_order",
          "description": "Check order status",
          "url": "https://api.example.com/orders",
          "method": "GET"
        }
      ]
    },
    "integrations": {
      "google_calendar": {
        "enabled": true,
        "user_timezone": "America/New_York"
      }
    },
    "transfer_enabled": true,
    "status": "active",
    "is_active": true,
    "sip_registration_data": null,
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

Response Fields

Core Fields

FieldTypeDescription
idstringUnique agent identifier (UUID)
organization_idstringOrganization the agent belongs to
namestringDisplay name of the agent
descriptionstringWhat the agent does
statusstringactive, inactive, cancelled, or pending
is_activebooleanComputed from status (true if status is active)

Conversation Configuration

FieldTypeDescription
greeting_messagestringFirst message spoken when call connects
system_promptstringAI instructions defining behavior
agent_typestringsimple, advanced, or custom

AI/Voice Models

FieldTypeDescription
modelstringLLM model: gpt-4o, gpt-4o-mini
voice_modelstringVoice model for realtime speech
stt_modelstringSpeech-to-text: deepgram
tts_modelstringText-to-speech: cartesia, minimax, deepgram
voice_settingsobjectTTS-specific voice configuration

Configuration Objects

FieldTypeDescription
configobjectGeneral settings (enable_recording, user_timezone, etc.)
extensionsobjectWebhook tools and MCP servers
integrationsobjectThird-party integrations (calendars, modmed)

Call Features

FieldTypeDescription
transfer_enabledbooleanWhether call transfer function is available
sip_registration_dataobjectSIP registration configuration (if set)

Timestamps

FieldTypeDescription
created_atdatetimeWhen the agent was created
updated_atdatetimeWhen the agent was last modified