curl --request GET \
--url 'https://response.stateset.com/api/v1/agents' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"object": "list",
"data": [
{
"object": "string",
"id": "string",
"name": null,
"type": null,
"description": null,
"activated": true,
"goal": null,
"role": null,
"updated_at": null,
"instructions": null,
"settings": {
"object": null,
"configured": null
}
}
],
"has_more": true,
"next_cursor": "string"
}
List agents
A list of agents
GET
/
api
/
v1
/
agents
curl --request GET \
--url 'https://response.stateset.com/api/v1/agents' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"object": "list",
"data": [
{
"object": "string",
"id": "string",
"name": null,
"type": null,
"description": null,
"activated": true,
"goal": null,
"role": null,
"updated_at": null,
"instructions": null,
"settings": {
"object": null,
"configured": null
}
}
],
"has_more": true,
"next_cursor": "string"
}
Query parameters
integer
integer
Response
object
string
Agent[]
boolean
string
Keyset cursor for the next page — present only on cursor-capable lists with more rows.
Status codes
| Code | Meaning |
|---|---|
200 | A list of agents |
401 | Missing, invalid, or expired API key. |
403 | The key lacks a required scope. |
429 | Rate limit exceeded. |
Access
| Required scope | agents:read |
| Rate limit | 120 requests per minute |
curl --request GET \
--url 'https://response.stateset.com/api/v1/agents' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"object": "list",
"data": [
{
"object": "string",
"id": "string",
"name": null,
"type": null,
"description": null,
"activated": true,
"goal": null,
"role": null,
"updated_at": null,
"instructions": null,
"settings": {
"object": null,
"configured": null
}
}
],
"has_more": true,
"next_cursor": "string"
}