curl --request GET \
--url 'http://localhost:8000/agents' \
--header "Authorization: Bearer $STATESET_AGENTS_API_KEY"
{
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-08-31T14:22:05Z",
"total": 102,
"page": 1,
"page_size": 20,
"has_next": false,
"has_prev": false,
"items": [
{
"agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"model_name": "string",
"created_at": "2026-08-31T14:22:05Z",
"conversation_count": 0,
"total_tokens_used": 0,
"config": {},
"status": "active"
}
]
}
List Agents
Get a paginated list of all agents.
GET
/
agents
curl --request GET \
--url 'http://localhost:8000/agents' \
--header "Authorization: Bearer $STATESET_AGENTS_API_KEY"
{
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-08-31T14:22:05Z",
"total": 102,
"page": 1,
"page_size": 20,
"has_next": false,
"has_prev": false,
"items": [
{
"agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"model_name": "string",
"created_at": "2026-08-31T14:22:05Z",
"conversation_count": 0,
"total_tokens_used": 0,
"config": {},
"status": "active"
}
]
}
Get a paginated list of all agents.
Query parameters
integer
Page number
integer
Items per page
string,null
Filter by status
Response
AgentListResponse-Input
string,null
Request tracking ID
string (date-time)
Response timestamp
integer
required
Total number of items
integer
Current page number
integer
Items per page
boolean
Whether there are more pages
boolean
Whether there are previous pages
AgentDetailResponse[]
Status codes
| Code | Meaning |
|---|---|
200 | List of agents |
401 | Authentication required |
422 | Validation Error |
429 | Rate limit exceeded |
curl --request GET \
--url 'http://localhost:8000/agents' \
--header "Authorization: Bearer $STATESET_AGENTS_API_KEY"
{
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-08-31T14:22:05Z",
"total": 102,
"page": 1,
"page_size": 20,
"has_next": false,
"has_prev": false,
"items": [
{
"agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"model_name": "string",
"created_at": "2026-08-31T14:22:05Z",
"conversation_count": 0,
"total_tokens_used": 0,
"config": {},
"status": "active"
}
]
}
Last modified on August 31, 2026