Get Agents

List all voice agents for your organization.

Endpoint

POST https://www.tabbly.io/api/get-agents

Authentication

See Introduction. This is a POST endpoint — include api_key in the JSON request body.

Request body

Parameter	Type	Required	Description
`api_key`	string	Yes	Your organization API key

Example request

curl -X POST "https://www.tabbly.io/api/get-agents" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY"
  }'

Response

Success (200)

{
  "status": "success",
  "count": 1,
  "data": [
    {
      "id": 6355,
      "agent_name": "My Voice Agent",
      "custom_first_line": "Hello, how can I help you?",
      "prompt_text": "You are a helpful assistant.",
      "phone_number": "+918031321970",
      "created_time": "2025-04-09 10:00:00"
    }
  ]
}

Field	Type	Description
`id`	integer	Voice agent ID
`agent_name`	string	Agent name
`custom_first_line`	string	Greeting text
`prompt_text`	string \| null	Agent prompt (null if not set)
`phone_number`	string \| null	Assigned phone number (null if not set)
`created_time`	string	UTC timestamp (`YYYY-MM-DD HH:MM:SS`)

Error responses

{
  "error": "Human-readable error description"
}

HTTP status	When
400	Missing API key
401	Invalid API key
500	Database error