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
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
'mine' (started by the caller) or 'shared' (started by someone else).
Cursor: the previous page’s last updatedAt.
Response
One page of agent runs (or the thread list).