SpecifyDocs

List agent sessions

/v1/work/agent-sessions

Signed-in sessionLaunch key product.workOperation agent_session_page

People follow what their agents are doing: open sessions, progress events, and the finished sessions that need a person to check them.

Query parameters

state"all" | "finished" | "needs_review" | "running" | "waiting"
cursorstring
agentClientIdstring
expectedAuthorizationVersionstring
limitnumber
workItemIdstring

Returns

contextobjectRequired
permission"not_permitted" | "permitted"Required
itemsnull | object[]Required
countobjectRequired
pagenull | objectRequired
freshnessobjectRequired

Errors

400, 401, 403, 404, 409, 429 and 503 return {"error": {"code", "message", "correlationId"}}.