Skip to main content
GET
/
agents
List Agents
curl --request GET \
  --url https://api.truedy.ai/api/public/v1/agents \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "agt_f9447372-5",
      "name": "Customer Support Agent",
      "description": "AI-powered customer support agent for handling inquiries",
      "status": "active",
      "voice_id": "voice_c7d82fec-c",
      "voice_name": "Sarah",
      "model": "gpt-4",
      "instructions": "You are a helpful customer support agent. Be friendly and professional.",
      "created_at": "2026-03-03T20:30:21.310278Z",
      "updated_at": "2026-03-03T20:30:21.310278Z"
    },
    {
      "id": "agt_f2ba550b-2",
      "name": "Sales Agent",
      "description": "Sales agent for product inquiries",
      "status": "active",
      "voice_id": "voice_c7d82fec-c",
      "voice_name": "Michael",
      "model": "claude-3-opus",
      "instructions": "You are a sales agent. Focus on understanding customer needs.",
      "created_at": "2026-03-03T20:30:21.310278Z",
      "updated_at": "2026-03-03T20:30:21.310278Z"
    }
  ],
  "meta": {
    "request_id": "req_32e7531c-8",
    "timestamp": "2026-03-03T20:30:21.310278Z",
    "count": 2
  }
}

Authorizations

Authorization
string
header
required

Your API key. Get it from the Truedy Dashboard. Send as: Authorization: Bearer <your_key>

Query Parameters

status
string

Filter by status (e.g. active, draft)

name
string

Filter by name (substring, case-insensitive)

limit
integer
default:50
Required range: 1 <= x <= 100
offset
integer
default:0
Required range: x >= 0

Response

Request completed successfully

Response body