Skip to main content
curl -X GET https://api.thinnest.ai/v2/agents \
  -H "Authorization: Bearer $THINNESTAI_API_KEY"

Query Parameters

limit
integer
default:"50"
Maximum number of agents to return (1–100)
offset
integer
default:"0"
Number of agents to skip for pagination

Response 200

{
  "agents": [
    {
      "id": "ag_c47e7c97_b2f2",
      "name": "Sales Agent",
      "model": "gpt-4o",
      "agentType": "simple",
      "voiceEnabled": false,
      "createdAt": "2026-03-07T10:00:00Z"
    },
    {
      "id": "ag_d58f8d08_c3g3",
      "name": "Phone Support",
      "model": "claude-3-5-sonnet-20241022",
      "agentType": "simple",
      "voiceEnabled": true,
      "createdAt": "2026-03-06T08:30:00Z"
    },
    {
      "id": "ag_e69g9e19_d4h4",
      "name": "Order Workflow",
      "model": "gpt-4o",
      "agentType": "graph",
      "voiceEnabled": false,
      "createdAt": "2026-03-05T14:15:00Z"
    }
  ],
  "total": 3
}

Response Fields

agents
array
List of agent summaries
agents[].id
string
Agent public ID (format: ag_*)
agents[].name
string
Agent display name
agents[].model
string
LLM model identifier
agents[].agentType
string
simple, graph, or workflow
agents[].voiceEnabled
boolean
Whether voice/phone is enabled
agents[].createdAt
string
ISO 8601 creation timestamp
total
integer
Total number of agents

Errors

CodeDescription
401Missing or invalid authentication