Reject an AI extraction review (discard the candidates)

Rejects a PENDING_REVIEW review and discards its candidates — nothing is ingested or reconciled. The rejecting principal is recorded for audit. Tenant from the JWT, context from the path.

POST /v1/imports/contexts/{contextId}/extraction-reviews/{reviewId}/reject

Reject an AI extraction review (discard the candidates)

cURL

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/extraction-reviews/{reviewId}/reject \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "poor scan quality, re-upload"
}
'

200

Example

{
  "candidates": [
    {
      "fields": [
        {
          "canonicalKey": "amount",
          "confidence": 0.95,
          "page": 1,
          "value": "100.50",
          "region": "<string>"
        }
      ],
      "source": "text_layer"
    }
  ],
  "contextId": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2025-01-15T10:30:00Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "sourceId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "PENDING_REVIEW",
  "updatedAt": "2025-01-15T10:35:00Z",
  "version": 1,
  "ingestionJobId": "550e8400-e29b-41d4-a716-446655440000",
  "rejectReason": "<string>",
  "reviewerId": "<string>"
}

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication (format: "Bearer {token}")

Parámetros de ruta

contextId · string<uuid> · requerido

Context ID

reviewId · string<uuid> · requerido

Review ID

Cuerpo

application/json

reason · string

Optional free-text reason for the rejection

Ejemplo:

"poor scan quality, re-upload"

Respuesta

200

application/json

OK

candidates · object[] | null · requerido

Proposed transaction candidates awaiting review

Show child attributes

contextId · string<uuid> · requerido

Reconciliation context the candidates belong to

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

createdAt · string<date-time> · requerido

Creation timestamp (RFC 3339, UTC)

Ejemplo:

"2025-01-15T10:30:00Z"

id · string<uuid> · requerido

Review identifier

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

sourceId · string<uuid> · requerido

Reconciliation source the candidates belong to

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

status · enum<string> · requerido

Review lifecycle: PENDING_REVIEW (awaiting decision), APPROVED (candidates ingested), REJECTED (discarded)

Opciones disponibles: PENDING_REVIEW, APPROVED, REJECTED

Ejemplo:

"PENDING_REVIEW"

updatedAt · string<date-time> · requerido

Last-update timestamp (RFC 3339, UTC)

Ejemplo:

"2025-01-15T10:35:00Z"

version · integer<int64> · requerido

Optimistic-concurrency version, incremented on each state change

Ejemplo:

1

ingestionJobId · string<uuid>

Downstream ingestion job linked on approval; null until linked

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

rejectReason · string

Free-text reason captured on rejection; empty otherwise

reviewerId · string

Principal id of the human who adjudicated the review; empty until decided