Skip to main content
GET
List Project To-dos
Returns the employer view (catalog, roster, all assignments) for a jobId, or the AI trainer view (their own effective list and history) for a contractId the token owns. An employer token with a contractId gets a job-view drilldown for that contract. Requires project_todos:read.
string
Employer view of one job. Required unless contractId is set.
string
One contract’s list — the AI trainer’s own view, or an employer drilldown.
string
Filter assignments: OPEN, IN_PROGRESS, SUBMITTED, COMPLETED, RETURNED, WAIVED, CLOSED, or SUPERSEDED.
string
Filter to one category.
string
Filter to one logical item.
string
Employer job view: filter assignments to one contract ID. Requires jobId.
boolean
true returns only SUBMITTED assignments awaiting employer review; false excludes them.
boolean
Include archived items and categories in the employer catalog for auditing.
string
Resume from a previous nextCursor.
number
Page size, 1–100 (default 25).
Conflicting filters fail with 400 — for example needsReview=true with a non-SUBMITTED status, or assignedTo without jobId.

Response

  • enabled — when the job has not enabled Project To-dos, the surface reads as inert: empty catalog and assignments, history retained.
  • categories and a flat items array for direct parsing, each item with its archivedAt, future-hire flag, and per-person progress counts.
  • people — the employer roster with contract ID, user ID, and a masked display name. Personal emails never appear.
  • assignments — paginated; each carries its immutable item version, status, due and blocking times, and append-only evidence and events.
  • summary — counts computed over the complete filtered result before pagination: items, archived items, assignments, open, completed, needs-review, and returned.
  • Worker views include blocking — whether required items currently gate project work.