drawings

Ingest Drawing

Idempotent ingest enqueue, plus the RUD-152 stale-retry mode.

Plain POST: unchanged — the partial unique index on pdf_extractions(drawing_id) WHERE status IN ('pending','running') makes it atomically idempotent (design spec §3.4). ?retry_stale=true: re-arm a STALE in-flight run in place and resend its message; non-stale/terminal rows no-op. Never inserts a fresh row while any extraction row exists. Uses the unscoped (service-role) connection because pgmq writes are infrastructure work; ownership is verified manually inside the repo functions.

post/api/v1/drawings/{drawing_id}/ingest

Path parameters

drawing_idstring uuid required

Query parameters

retry_staleboolean

Response

Successful Response

createdboolean required

Changes

No recorded changes to this endpoint across all 2 revisions of this API.