リファレンスHTTP APIPending requests

Open permission and question requests

GET
/v1/sessions/{id}/pending-requests

Lists the permission and question requests the session waits on that a client can still answer, oldest first: open, unexpired, and either raised by the worker attempt that holds the running turn (state: waiting) or parked (state: parked). A request nobody answers by park_at has its turn parked: the platform stops the turn with its checkpoint and pauses the session, and the request stays answerable until expires_at whatever happened to the worker that asked. Requests of one group resume their turn together. A permission item names the tool and its input; a question item carries the questions and their option ids. Answer before expires_at with POST /v1/sessions/{id}/answers. New requests also arrive as question events on the event stream. It changes nothing.

Scope: sessions:read (API key or cookie session).

Authorization

headerAuthorizationBearer <token>

For servers and scripts: an API key sent as an HTTP bearer token, Bearer <key>. It holds exactly the scopes it was issued with; a key issued before scopes existed holds none. It never needs the CSRF header, and it cannot manage agents, members, teams or API keys. Issue one in the web console under Settings → API keys; each operation names the scope it needs.

Scope: sessions:read

Path Parameters

id*string

The session's id.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

Every request that can be answered now; empty when none.

application/json
  1. response
items*array<|>
answerable*boolean

Whether this caller may answer the session's requests: its creator, its agent's admins and the workspace's owners and admins may; someone who only sees it through its share may not (POST /answers is then 403). A hint for what to offer; the answer is judged again.

Example Request
curl -X GET 'https://example.com/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/pending-requests'
Example Response
{  "items": [    {      "request_id": "req_7f3a",      "turn_id": "2",      "attempt_id": "att_01",      "created_at": "2026-10-11T08:14:30Z",      "expires_at": "2026-10-12T08:14:30Z",      "state": "waiting",      "park_at": "2026-10-11T08:44:30Z",      "group": "2",      "kind": "permission",      "tool": "Bash",      "input": {        "command": "npm test",        "description": "Run the tests"      }    }  ],  "answerable": true}