API Reference

Extract

Review

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Reject Extract Review

ExtractReview Extract.Review.Reject(ReviewRejectParamsparameters, CancellationTokencancellationToken = default)

POST/api/v2/extract/{job_id}/review/reject

Beta: answers 403 until extract review is enabled for the caller and their organization.

Reject the result, with a reason. A job that failed or was cancelled can be rejected, which closes a review turned on while it ran. A job still queued or running answers 409 with code: job_not_reviewable. A revision other than the review’s latest answers 409 with code: stale_revision and the latest revision.

ParametersExpand Collapse

ReviewRejectParams parameters

required string jobID

Path param

required string reason

Body param: Why the result was rejected.

minLength1

required Long revision

Body param: The review’s revision as the caller last read it.

minimum0

string? organizationID

Query param

formatuuid

string? projectID

Query param

formatuuid

ReturnsExpand Collapse

class ExtractReview:

An extract job’s review: its settings, flags, field actions and decision, with the result as read and as reviewed.

required string ID

Unique identifier of the review.

required Double ConfidenceThreshold

Fields read below this confidence are flagged.

required DateTimeOffset CreatedAt

When review was turned on.

formatdate-time

required DateTimeOffset? DecidedAt

When it was approved or rejected.

formatdate-time

required string? DecidedBy

ID of the user who approved or rejected it.

required string? DecidedReason

Why it was rejected.

required IReadOnlyDictionary<string, FieldActionsItem> FieldActions

The latest action per field, keyed by JSON Pointer.

required Action Action

confirm, correct or clear.

One of the following:

"clear"Clear

"confirm"Confirm

"correct"Correct

required string ActorID

ID of the user who acted.

required DateTimeOffset At

When they acted.

formatdate-time

JsonElement Value

The corrected value, for correct.

required IReadOnlyList<string> FieldsInScope

JSON Pointers of the fields the threshold applies to; empty means all.

required IReadOnlyList<Flag> Flags

Fields the review asks a person to check.

required Boolean Handled

Whether someone confirmed, corrected or cleared it.

required string Path

JSON Pointer of the field.

required Reason Reason

below_threshold, or required_empty for a required field left empty.

One of the following:

"below_threshold"BelowThreshold

"required_empty"RequiredEmpty

Cell? Cell

Where in a list the least confident value is.

required Long Row

Index of the row, from 0.

string? Column

Property of the row, when rows are objects.

Double? Confidence

The field’s confidence; for a list, its least confident value.

required string JobID

The extract job reviewed.

required IReadOnlyList<string> OpenFlags

JSON Pointers of flagged fields nobody checked.

required IReadOnlyDictionary<string, JsonElement>? OriginalResult

The result as the model read it.

required IReadOnlyList<string> RequiredFields

JSON Pointers of fields flagged when empty.

required DateTimeOffset RetainUntil

When the job and its document may be deleted.

formatdate-time

required IReadOnlyDictionary<string, JsonElement> ReviewedResult

The result with the field actions.

required Long Revision

Bumped by every change; actions name the one they saw.

required string? SourceFileID

The file the job read, or the file behind the parse job it read; null for a URL.

required Status Status

pending until approved or rejected.

One of the following:

"approved"Approved

"pending"Pending

"rejected"Rejected

required DateTimeOffset UpdatedAt

When the review last changed.

formatdate-time

Reject Extract Review

C#

HTTP

TypeScript

Python

Go

Java

C#

CLI Tool

ReviewRejectParams parameters = new()
{
    JobID = "job_id",
    Reason = "The invoice total does not match the line items.",
    Revision = 0,
};

var extractReview = await client.Extract.Review.Reject(parameters);

Console.WriteLine(extractReview);

200 example

{
  "id": "id",
  "confidence_threshold": 0,
  "created_at": "2019-12-27T18:11:19.117Z",
  "decided_at": "2019-12-27T18:11:19.117Z",
  "decided_by": "decided_by",
  "decided_reason": "decided_reason",
  "field_actions": {
    "foo": {
      "action": "clear",
      "actor_id": "actor_id",
      "at": "2019-12-27T18:11:19.117Z",
      "value": {}
    }
  },
  "fields_in_scope": [
    "string"
  ],
  "flags": [
    {
      "handled": true,
      "path": "path",
      "reason": "below_threshold",
      "cell": {
        "row": 0,
        "column": "column"
      },
      "confidence": 0
    }
  ],
  "job_id": "job_id",
  "open_flags": [
    "string"
  ],
  "original_result": {
    "foo": "bar"
  },
  "required_fields": [
    "string"
  ],
  "retain_until": "2019-12-27T18:11:19.117Z",
  "reviewed_result": {
    "foo": "bar"
  },
  "revision": 0,
  "source_file_id": "source_file_id",
  "status": "approved",
  "updated_at": "2019-12-27T18:11:19.117Z"
}

Returns Examples

200 example

{
  "id": "id",
  "confidence_threshold": 0,
  "created_at": "2019-12-27T18:11:19.117Z",
  "decided_at": "2019-12-27T18:11:19.117Z",
  "decided_by": "decided_by",
  "decided_reason": "decided_reason",
  "field_actions": {
    "foo": {
      "action": "clear",
      "actor_id": "actor_id",
      "at": "2019-12-27T18:11:19.117Z",
      "value": {}
    }
  },
  "fields_in_scope": [
    "string"
  ],
  "flags": [
    {
      "handled": true,
      "path": "path",
      "reason": "below_threshold",
      "cell": {
        "row": 0,
        "column": "column"
      },
      "confidence": 0
    }
  ],
  "job_id": "job_id",
  "open_flags": [
    "string"
  ],
  "original_result": {
    "foo": "bar"
  },
  "required_fields": [
    "string"
  ],
  "retain_until": "2019-12-27T18:11:19.117Z",
  "reviewed_result": {
    "foo": "bar"
  },
  "revision": 0,
  "source_file_id": "source_file_id",
  "status": "approved",
  "updated_at": "2019-12-27T18:11:19.117Z"
}