v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB

Ingestion

Enqueue a document for AI extraction (human-review required)

Stores the uploaded source document tenant-scoped, runs deterministic + AI extraction, and enqueues the resulting transaction CANDIDATES in a human-review queue. AI output is NEVER authoritative: no transaction is reconciled until a human approves the review. The lane is gated by a global kill-switch AND a per-tenant opt-in (fail-closed: a non-opted-in tenant gets 403). The tenant is resolved from the JWT and the context/source from the path — never from the body.

post/v1/imports/contexts/{contextId}/sources/{sourceId}/extract-document

Path parameters

contextIdstring uuid required

Context ID

sourceIdstring uuid required

Source ID

Response

Accepted

candidateCountinteger required

Number of transaction candidates queued for review

reviewIdstring uuid required

Identifier of the queued extraction review

statusstring required

Lifecycle status of the queued review (always PENDING_REVIEW on enqueue)

Example response

{
  "candidateCount": 12,
  "reviewId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "PENDING_REVIEW"
}