SpecifyDocs

List work needs yous

/v1/work/needs-you

Signed-in sessionLaunch key product.workOperation work_needs_you_page

Attention collects what needs a person: agent approval requests and questions, sessions an agent blocked on or asked to have reviewed, memory proposals to review, Security exception requests, their own tasks that are due, and notifications.

Query parameters

kind"blocked" | "decisions" | "exceptions" | "memory" | "questions" | "review"
view"answered" | "waiting"
cursorstring
sincenumber
expectedAuthorizationVersionstring
limitnumber

Returns

contextobjectRequired
permission"not_permitted" | "permitted"Required
itemsnull | object[]Required
countobjectRequired
pagenull | objectRequired
freshnessobjectRequired
countsnull | objectRequired
omitted"blocked" | "decisions" | "exceptions" | "memory" | "questions" | "review"[]Required

Errors

400, 401, 403, 404, 409, 429 and 503 return {"error": {"code", "message", "correlationId"}}. A call without a valid credential gets 401 before its input is checked, and so does an address that is not an operation: 404 and 400 come only once the credential is accepted. Public operations answer without one.