curl -X GET https://api.thinnest.ai/v2/agents \
-H "Authorization: Bearer $THINNESTAI_API_KEY"
Query Parameters
Maximum number of agents to return (1–100)
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
Agent public ID (format: ag_*)
simple, graph, or workflow
Whether voice/phone is enabled
ISO 8601 creation timestamp
Errors
| Code | Description |
|---|
401 | Missing or invalid authentication |