Skip to main content
Define the structure you want with JSON Schema. For an object, list every property in required and set additionalProperties to false.
For multipart requests, send schema as a JSON string. For a request using parse_id, send it as a JSON object. The Extract guide shows both encodings.

Add guidance only when needed

The optional prompt field provides instructions for filling your schema, such as how to normalize a date. The schema still defines the returned structure. A prompt does not create a confidence score or guarantee populated citations.

Correct a rejected schema

malformed_schema_json indicates invalid JSON; check quoting and syntax. invalid_schema indicates an unsupported schema; check required properties and additionalProperties. See limits for schema and prompt size constraints.