Extractions

Correct extracted field values

Alias of PATCH /v1/extractions/{id}/data, with identical semantics. Overrides field values on an extraction (each set to confidence 1.0 and locked) by writing new value-plane cell versions under the cell-write authority guard; fields the guard withholds come back in cells_skipped and are left unchanged. Body is a flat map of field name to corrected value. Requires write scope.

post/v1/extractions/{id}/correct

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/extractions/{id}/correct
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Request body

object required

Map of field name → corrected value.

Response

Updated extraction, with the value-plane correction outcome.

idstring uuid required
status'complete' | 'failed' | 'processing' required
dataobject required

Extracted key-value pairs.

locked_fieldsstring[]

Fields that have been manually corrected (locked at confidence 1.0).

batch_idstring

The caller grouping key stamped on this document at ingestion (documents.client_batch_id) — e.g. from POST /v1/run or POST /v1/sources/:id/documents. Present only when set.

metadataobject

The caller's flat metadata bag stamped on this document at ingestion (documents.client_metadata) — for a /v1/run input, its per-request EFFECTIVE merged bag (call-level metadata merged with any file_metadata entry). Present only when set.

created_atstring date-time
value_plane'written' | 'not_migrated' required

written — the corrections landed as new value-plane cell versions. not_migrated — the document has no capture-layer record yet, so the correction was applied to the legacy extraction JSONB only.

cells_writtenstring[] required

Field names that became new value-plane cell versions.

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "document": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "filename": "invoice-042.pdf"
  },
  "processing": {
    "region": "eu-west"
  },
  "created_at": "2026-04-25T14:30:00.000Z"
}

Changes

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