Create Extraction Job
POST/extractions/jobs
Start a structured data extraction job.
Creates a background job to extract structured data from a document based on a JSON schema. Returns a job ID that can be used to poll for the result.
Indexing requirement: The document must be indexed before extraction can run. If the document is not yet indexed when this request is received, the job will wait until indexing completes before starting. Upload documents in advance to minimize latency.
Schema handling: Each request stores its schema as a standalone record
scoped to this run. These API-created schemas are kept separate from the
project's auto-extraction schema library — they do not appear in the
project's auto-extraction configuration UI or in project search filters.
The extraction happens in the background. Use the GET /extractions/jobs/{job_id} endpoint
to check status and retrieve results.
Request
Responses
- 201
- 401
- 403
- 404
- 422
Extraction job created successfully
Unauthorized
Forbidden
Not Found
Unprocessable Entity