Conspectus

PATCH /api/v1/conspectuses/{conspectus_uuid}

Specification. Intended partial update of ETR fields (title, cue_sheet, dense_paragraph, bullets). Ownership via system_user_id and system_uuid in the body. Does not change scheduling; for retrieve transitions see POST …/actions/review. Planned operationId: patchConspectus.

Planned operationId: patchConspectus

Path, body, idempotency

Path: conspectus_uuid. Body: composite owner key plus any subset of ETR fields to change.

Idempotency: required. Namespace endpoint_path = "PATCH /api/v1/conspectuses/{conspectus_uuid}" with the concrete UUID (same pattern as PATCH /api/v1/user/…).

Success: 200 OK — full ConspectusResponse.

Errors

HTTP Code / key When
400 COMMON_400 Missing Idempotency-Key.
400 CONS_102 / CONSPECTUS_PATCH_BODY_EMPTY Body has owner fields only — no ETR field to update.
404 USER_404 / CONS_404 User or conspectus not found for this key.
409 COMMON_409 Idempotency key reused with different body.

Single-file deep spec

Conspectus hub — this operation

← Conspectus resource hub

Page history

Date Change Author
Added Page history section (repository baseline). Ivan Boyarkin