NAnace
document-operations

validate_extract_schema

Validate an extraction schema without creating a job or consuming credits.

Cost class: fast (pure validation, no I/O, no model inference).

Use this before submitting an extract job to catch schema errors up front. On success valid=True and normalized_schema carries the compiled form the extraction pipeline will use. On failure valid=False and errors lists every violation — the whole list, not just the first.

post/v1/extract/schema-validation

Request

Request body

schemaobject nullable

Inline JSON Schema to validate. Mutually exclusive with schema_id.

schema_idstring nullable

Catalog schema family id (sch_...). Mutually exclusive with an inline schema.

schema_versioninteger nullable

Pin a published catalog version. Omit with schema_id to use the latest version.

Response

Successful Response

normalized_schemaobject nullable

Compiled schema when valid is true. Null when the input was rejected.

validboolean required

True when the schema can be used as an extract schema.

Changes

No recorded changes to this operation across all 2 revisions of this API.