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
Changes
No recorded changes to this endpoint across all 2 revisions of this API.