Skip to main content
GET

Overview

A member’s queue: the organization’s open cases, across all of its goals, whose record names the member as owner. An owner that is an organization member’s email puts the case in that member’s queue; the match is case-insensitive on the trimmed address. Any other text is a label only, and the case is in nobody’s queue. A case is open while its state is not one of the goal’s finished_states, and not unreached or cancelled. An open case is waiting while it sleeps until a time still ahead (wait_until), and to do otherwise. The queue is sorted by due_date, soonest first; cases with no due date come last, in the order they were opened. A member acts on a case by posting to it.

Authentication

A signed-in organization member.

Query Parameters

number
default:"50"
Cases per page, 1 to 200
string
page.next_cursor from the previous answer, sent with the same filters
string
Only this goal’s cases
string
Only cases in this state
string
todo, in the queue’s order, or waiting, soonest to wake first
string
Search, 1 to 100 characters: part of the case key or its facts, any case
string
recent: the member’s cases that finished in the last seven days instead, newest first. Not with bucket

Summary

GET /v1/org/cases/mine/summary counts: total, overdue, due_week (not overdue, due within seven days), waiting, done_recent (as done=recent lists), and goals with open cases (goal_id, title, queue_title (case-view queue name or null), count, waiting, done_recent) and states (state, count), most cases first. Bare dates and midnight-UTC timestamps (including update_case dates) become overdue after their UTC day; other timestamps, at their instant. Undated cases never count toward overdue or due_week.

Response

object[]
One item per case: goal_id, goal_title, key, state, owner, next_action, due_date, latest_output (evidence_key, the last key the record lists, and result, the latest delivered result), person_actions, facts, outputs, priority_reason, recorded, last_event (the latest person action), timezone, country, wait_until, opened_at and ended_at
object
Each goal on the page by id: its case view, the screen a person works its cases on, or null while it has none
string | null
Pass as cursor for the next page of the same list; null on the last

Errors