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

Request

Base URL
https://identity.sandbox.lerian.net
Auth
HTTP bearer
TypeScript
https://skmtc.dev/lerian/apis/identity-plugin/docs/v1/imports/contexts/:contextId/sources/:sourceId/extract-document/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

contextIdstring uuid required

Context ID

sourceIdstring uuid required

Source ID

Request body application/pdf

string binary required

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"
}

Changes

No recorded changes to this operation across all 1 revision of this API.