---
title: "Create a document reprocessing job"
method: POST
path: "/api/v0/documents/{document_id}/reprocessing-jobs"
tags: ["Documents"]
---

# Create a document reprocessing job

`POST /api/v0/documents/{document_id}/reprocessing-jobs`

Creates a new job to reprocess an existing document without changing its file content.

## Path parameters

- `document_id` string, uuid, required

## Request body

- ReprocessingRequest — Request body for document/page reprocessing. Empty/missing `pages` reprocesses the whole document. A non-empty list reprocesses exactly the listed pages, dispatched in parallel with a single finalize_document fan-in after they all complete.
  - `pages` PageReprocess[], nullable — Pages to reprocess. Omit (or pass an empty list) to reprocess the whole document.
    - `page_number` integer, required — 0-indexed page number to reprocess.
    - `page_type` 'mechanical_drawing' | 'electrical_drawing' | 'schematic_drawing' | 'engineering_drawing' | 'general_document' — Page type classification for document processing. Used to determine which detector/parser to use for each page.
  - `skip_visual_transcription` boolean, nullable — When True, skip VLM-based transcription for visual components. Tables use raw OCR, flowcharts/charts are empty.

## Response `200`

Successful Response

- DocumentPostResponse
  - `job_status_id` string, uuid, required — The ID of the job status.
  - `status` string, required — The status of the job. Options: `pending`, `done`, `error`.
  - `error_message` string, nullable, required — The error message if the job failed.
  - `document_id` string, uuid, nullable, required — The ID of the document that was uploaded.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/outerport/apis/outerport-api.md) · [All operations](https://skmtc.dev/outerport/apis/outerport-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/outerport/outerport-api/revisions/f565b46daaea/schema)