Skip to main content
GET
/
agent
/
{agent_id}
Get Agent
curl --request GET \
  --url https://api.callaidan.com/agent/{agent_id}/ \
  --header 'Authorization: <api-key>'
{
  "id": "<string>",
  "name": "<string>",
  "type": "chatbot",
  "prompt": "<string>",
  "model": "<string>",
  "first_message": "<string>",
  "tools": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "type": "<string>",
      "url": "<string>",
      "mcp_tool": "<string>",
      "method": "<string>",
      "auth_token": "<string>",
      "is_async": true,
      "is_success": true,
      "icon_url": "<string>",
      "messages": [
        {
          "type": "<string>",
          "content": "<string>"
        }
      ],
      "schema": [
        {
          "id": "<string>",
          "name": "<string>",
          "description": "<string>",
          "type": "<string>",
          "required": true
        }
      ]
    }
  ],
  "files": [
    {
      "id": "<string>",
      "name": "<string>",
      "file": true,
      "type": "<string>",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "platforms": [
    {
      "id": "<string>",
      "platform": "<string>",
      "min_delay": 123,
      "max_delay": 123,
      "trigger": "<string>",
      "active": true
    }
  ],
  "language": "<string>",
  "voice": {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "provider": "<string>",
    "accent": "<string>",
    "gender": "<string>",
    "previewUrl": "<string>"
  },
  "background": "lounge",
  "background_url": "<string>",
  "variables": [
    {
      "variable": "<string>",
      "default": "<string>"
    }
  ],
  "advanced": {
    "timezone": "<string>",
    "interrupt_mode": true,
    "hipaa_enabled": true,
    "forwarding_number": "<string>",
    "voicemail_message": "<string>",
    "end_call_message": "<string>",
    "unqualified_prompt": "<string>",
    "scoring_prompt": "<string>",
    "summary_prompt": "<string>",
    "keyterms": "<string>",
    "webhook_url": "<string>",
    "log_to_crm": true,
    "recording_consent_message": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Company API Key

Path Parameters

agent_id
string
required

The ID of the agent to retrieve

Response

Agent details retrieved successfully

id
string

Unique identifier for the agent

name
string

Name of the agent

type
enum<string>

Type of agent

Available options:
chatbot,
voicebot
prompt
string

System prompt for the agent

model
string

AI model used by the agent

first_message
string

Initial message sent by the agent

tools
object[]
files
object[]
platforms
object[]

Platform integrations (chatbot only)

language
string

Language for the agent (voicebot only)

voice
object

Voice settings (voicebot only)

background
enum<string>

Background audio (voicebot only). Set to "url" to use a custom MP3 provided via background_url.

Available options:
lounge,
off,
url
background_url
string<uri>

Public URL for custom background audio (voicebot only, used when background is set to "url")

variables
object[]

Custom variables (voicebot only)

advanced
object