Extraction runs only after schema approval. A queued document is not an extracted or searchable result.

Last updated: 2026-09-27 Product area: Extraction Page type: Tutorial

First extraction

Video walkthrough: approving a schema and running your first stored extraction.

Follow Quickstart until discovery has proposed fields and you have approved them. This page is the run itself.

Before you run

Stored workspace, not non-retaining.
At least five text-bearing documents if you are in the guided discovery minimum.
Role that can run extraction. Viewers cannot.
If the run calls a generation model, an owner or admin has saved the organization key that matches that model.

Start the extraction from the approved configuration. Scope can be the discovery sample or the full collection. Sample scope uses the documents recorded on the approved discovery.
Leave the run in processing if needed. Status processing means the job was queued or is running. Status error means it stopped. Retry the same confirmation when the queue was unavailable (DOCUMENT_PROCESSING_QUEUE_UNAVAILABLE). Do not upload a second copy to force a retry.
Open the run when it reaches a terminal success state and confirm Smart Bites exist for the documents you expect.

Upload confirm returning 201. That inserts the document and enqueues processing.
A saved agent or schema with no run id.
A read probe on a source connection.

Record the run id if you need support. Do not attach document text.