API ReferenceCorrectionsUpdate Correction

Update Correction

PATCH /api/v1/jobs/{job_id}/corrections/{id}/

Update an existing correction. All fields in the request body are optional — only the provided fields will be updated.

Authentication

Requires an API key with jobs:write scope. Pass via the X-API-Key header.

Path Parameters

ParameterTypeDescription
job_idstring (UUID)The ID of the extraction job.
idstring (UUID)The ID of the correction to update.

Request Body

All fields are optional. Only provided fields will be updated.

FieldTypeDescription
correction_typestringType of correction: wrong_value, wrong_field, missing_field, or spurious.
field_pathstringDot-notation path to the corrected field.
original_valuestringThe original extracted value.
corrected_valuestringThe corrected value.
notesstringOptional explanation for the correction.
{
  "corrected_value": "5300.00",
  "notes": "Updated after re-checking source document"
}

Response

Status: 200 OK

{
  "id": "f6a7b8c9-0123-4567-89ab-cdef01234567",
  "job_id": "e5f6a7b8-c901-2345-6789-abcdef012345",
  "correction_type": "wrong_value",
  "field_path": "employees[0].gross_pay",
  "original_value": "5000.00",
  "corrected_value": "5300.00",
  "notes": "Updated after re-checking source document",
  "created_at": "2026-03-16T12:00:00Z"
}

Response Fields

FieldTypeDescription
idstring (UUID)Unique identifier for the correction.
job_idstring (UUID)The extraction job this correction belongs to.
correction_typestringType of correction applied.
field_pathstringDot-notation path to the corrected field.
original_valuestringThe original extracted value.
corrected_valuestringThe corrected value.
notesstring or nullOptional explanation for the correction.
created_atstring (ISO 8601)Timestamp when the correction was created.

Errors

StatusDescription
400Invalid request body or unknown correction_type.
401Missing or invalid API key.
403API key does not have jobs:write scope.
404Extraction job or correction not found.

Code Examples

curl -X PATCH https://api.parsifyhq.com/api/v1/jobs/e5f6a7b8-c901-2345-6789-abcdef012345/corrections/f6a7b8c9-0123-4567-89ab-cdef01234567/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "corrected_value": "5300.00",
    "notes": "Updated after re-checking source document"
  }'