curl --silent --show-error --fail-with-body --request GET \
--url 'https://response.stateset.com/api/v1/workspace' \
--header "Authorization: Bearer $RESPONSECX_API_KEY"
{
"object": "workspace",
"agent_count": 1,
"active_agent_count": 1,
"unverified_agent_count": 1,
"agents": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"type": "standard",
"activated": true,
"has_instructions": true,
"rule_count": 1,
"function_count": 1,
"eval_count": 1,
"updated_at": "2026-08-31T14:22:05Z"
}
],
"next_action": "string"
}
Orientation: agents, configuration state, and a suggested next action
The org’s agents with their configuration state, the three top-level counts, and a suggested next action.
GET
/
api
/
v1
/
workspace
curl --silent --show-error --fail-with-body --request GET \
--url 'https://response.stateset.com/api/v1/workspace' \
--header "Authorization: Bearer $RESPONSECX_API_KEY"
{
"object": "workspace",
"agent_count": 1,
"active_agent_count": 1,
"unverified_agent_count": 1,
"agents": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"type": "standard",
"activated": true,
"has_instructions": true,
"rule_count": 1,
"function_count": 1,
"eval_count": 1,
"updated_at": "2026-08-31T14:22:05Z"
}
],
"next_action": "string"
}
Response
object
string
required
Allowed values:
'workspace'.integer
required
integer
required
Agents with
activated: true.integer
required
Agents with
eval_count: 0 — nothing checks they still behave after a change.object[]
required
Ordered by
updated_at descending.Show agents
Show agents
string (uuid)
required
string,null
required
string,null
required
boolean
required
boolean
required
Whether the agent has a non-empty
instructions persona.integer
required
Best-effort: falls back to 0 if the count query fails.
integer
required
Best-effort: falls back to 0 if the count query fails.
integer
required
Best-effort: falls back to 0 if the count query fails.
string,null (date-time)
required
string
required
A one-sentence suggestion, in order of priority: create an agent; give an agent instructions; add a rule; add evals; activate; or run evals / review analytics.
Status codes
| Code | Meaning |
|---|---|
200 | The org’s agents with their configuration state, the three top-level counts, and a suggested next action. |
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 |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request GET \
--url 'https://response.stateset.com/api/v1/workspace' \
--header "Authorization: Bearer $RESPONSECX_API_KEY"
{
"object": "workspace",
"agent_count": 1,
"active_agent_count": 1,
"unverified_agent_count": 1,
"agents": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"type": "standard",
"activated": true,
"has_instructions": true,
"rule_count": 1,
"function_count": 1,
"eval_count": 1,
"updated_at": "2026-08-31T14:22:05Z"
}
],
"next_action": "string"
}
Last modified on September 21, 2026