The caller’s agent runs (and threads)
The caller’s agent runs (and threads)
Lists agent runs in every container the caller can read — their own desk plus every space they hold `space:read` on — newest activity first. Each row carries `startedBy` and the container `spaceTitle` (null for desks), so a client can split "mine" from "shared with me"; `?scope=mine|shared` filters to one side. Other filters: `status` and `threadId`. `?group=thread` collapses to the newest run per thread (the thread list, up to 20; no further paging) and is the only mode that derives `threadStatus` — `running` while a run is live, `unread` when the thread moved since the caller last marked it seen (`POST /me/threads/{threadId}/view`, with a 30-second grace on a brand-new thread), `idle` otherwise. Every other mode reports `idle`. Otherwise cursor-paginated via `starting_after` (the previous page’s last `updatedAt`), 20 runs per page. Reads best-effort projections — the envelope `asOf` and per-row `updatedAt` mark staleness. `totalCount` is the (scan-capped) number of matching runs. Authorization: any authenticated member; another member’s desk threads are never listed, organization administrators included.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
status
Filter to one run status.
threadId
Filter to one thread.
scope
‘mine’ (started by the caller) or ‘shared’ (started by someone else).
group
Set to 'thread' to collapse to the newest run per thread.
starting_after
Cursor: the previous page’s last updatedAt.
Response
One page of agent runs (or the thread list).
data
totalCount
nextCursor
asOf