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

curl --request GET \
  --url 'https://response.stateset.com/api/v1/workspace' \
  --header "Authorization: Bearer $RESPONSECX_API_KEY"

200

{
  "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

object · string · required

agent_count · integer · required

active_agent_count · integer · required

Agents with activated: true.

unverified_agent_count · integer · required

Agents with eval_count: 0 — nothing checks they still behave after a change.

agents · object[] · required

Ordered by updated_at descending.

Show agents

id · string (uuid) · required

name · string,null · required

type · string,null · required

activated · boolean · required

has_instructions · boolean · required

Whether the agent has a non-empty instructions persona.

rule_count · integer · required

Best-effort: falls back to 0 if the count query fails.

function_count · integer · required

Best-effort: falls back to 0 if the count query fails.

eval_count · integer · required

Best-effort: falls back to 0 if the count query fails.

updated_at · string,null (date-time) · required

next_action · 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

cURL

curl --request GET \
  --url 'https://response.stateset.com/api/v1/workspace' \
  --header "Authorization: Bearer $RESPONSECX_API_KEY"

200

{
  "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"
}