List Approvals V1

List approval requests for the calling tenant. Approvals fire when a job hits an action gated by an approval policy (typically destructive operations on…

GET /api/v1/approvals

cURL

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/approvals' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"

200

[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tool_name": "string",
    "tool_input": {},
    "reasoning": "string",
    "screenshot_key": "string",
    "status": "pending",
    "review_comment": "string",
    "expires_at": "2026-08-31T14:22:05Z",
    "created_at": "2026-08-31T14:22:05Z",
    "updated_at": "2026-08-31T14:22:05Z"
  }
]

List approval requests for the calling tenant.

Approvals fire when a job hits an action gated by an approval policy (typically destructive operations on connected services). The job sits in awaiting_approval status until a reviewer calls /approvals/{id}/approve or /reject.

Query parameters

pending_only · boolean

When true (default) only return rows still awaiting review. Pass false to include approved/rejected/expired rows for audit dashboards.

Response

ApprovalSummary[] — each element:

id · string · required

job_id · string · required

tool_name · string · required

tool_input · object · required

reasoning · string,null · required

screenshot_key · string,null · required

status · string · required

review_comment · string,null · required

expires_at · string,null · required

created_at · string · required

updated_at · string · required

Status codes

Code	Meaning
200	Successful Response
422	Validation Error

cURL

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/approvals' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"

200

[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tool_name": "string",
    "tool_input": {},
    "reasoning": "string",
    "screenshot_key": "string",
    "status": "pending",
    "review_comment": "string",
    "expires_at": "2026-08-31T14:22:05Z",
    "created_at": "2026-08-31T14:22:05Z",
    "updated_at": "2026-08-31T14:22:05Z"
  }
]