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.

jobIdstringquery

Employer view of one job. Required unless contractId is set.

contractIdstringquery

One contract’s list — the AI trainer’s own view, or an employer drilldown.

statusstringquery

Filter assignments: OPEN, IN_PROGRESS, SUBMITTED, COMPLETED, RETURNED, WAIVED, CLOSED, or SUPERSEDED.

categoryIdstringquery

Filter to one category.

itemIdstringquery

Filter to one logical item.

assignedTostringquery

Employer job view: filter assignments to one contract ID. Requires jobId.

needsReviewbooleanquery

true returns only SUBMITTED assignments awaiting employer review; false excludes them.

includeArchivedbooleanquery

Include archived items and categories in the employer catalog for auditing.

cursorstringquery

Resume from a previous nextCursor.

limitnumberquery

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.