List deliverables
GET/api/deliverables
List deliverables. When called without fields, returns the full paginated deliverable shape (with relations) for the active organisation, filtered to projects the caller can see. Requires projects.read or projects.read.own. Pass ?fields=minimal&projectId=… to receive only id, title, and status for a specific project — that mode evaluates permissions against the project's organisation (after verifyProjectAccess) and accepts projects.read, projects.read.own, gates.create, or gates.update. Minimal mode pages up to 100 rows at a time and is used by the gate criterion deliverable-picker UI.
Request
Responses
- 200
- 400
- 401
- 403
Successful response
Bad Request — unsupported fields value, missing projectId in minimal mode, projectId is not a valid UUID, or ids contains a non-UUID / empty list / more than 100 entries (minimal mode); validation failure on query params (full mode)
Unauthorized — authentication credentials are missing or invalid
Forbidden — full listing requires projects.read or projects.read.own; ?fields=minimal requires one of projects.read, projects.read.own, gates.create, or gates.update against the project owning organisation