Conspectus
GET
/api/v1/conspectuses/due
Specification. Intended: list conspectuses for a user that are due on or before
due_before (defaults to UTC now), optionally filtered by slot (A–D).
Planned operationId: listDueConspectuses.
Planned operationId: listDueConspectuses
Query parameters and behavior
Required: system_user_id, system_uuid (query). Optional:
due_before (datetime, timezone-aware; default: now UTC), slot (enum
A|B|C|D).
Intended implementation: filter by next_review_at <= due_before, optional equality on
slot; order by next_review_at ascending, then conspectus_uuid.
Success: 200 OK — JSON array of ConspectusResponse (may be empty).
No idempotency (read-only).
Errors
| HTTP | When |
|---|---|
404 |
USER_404 — user not found for composite key. |
422 |
Invalid query types (e.g. bad slot if validation fails). |
401 / 429 |
Middleware. |
Single-file deep spec
Page history
| Date | Change | Author |
|---|---|---|
| Added Page history section (repository baseline). | Ivan Boyarkin |