Represents a reusable JSON schema definition for structured assistant outputs. JSON schemas enable assistants to return validated, type-safe responses in a specific format.
id string
Unique identifier for the JSON schema. Format: schema_ followed by alphanumeric characters.
name string
Human-readable name for the schema. Used for identification in lists and UI.
description string optional
Description of what this schema is used for and what data it represents.
schemaObject object
The actual JSON schema definition following the JSON Schema specification. Defines the structure, types, and validation rules for the output.
organization_id string
The organization this schema belongs to.
created_by string
User ID of the person who created this schema.
isActive boolean
Whether this schema is active and available for use.
version integer
Version number of the schema. Increments with each update.
created_at integer
Unix timestamp (seconds) when the schema was created.
updated_at integer
Unix timestamp (seconds) when the schema was last modified.
JSON schemas are referenced by assistants to enable structured output mode. When an assistant has output_mode set to json_schema, it will validate its responses against the specified schemas.
- Assistant Object - Assistants can use multiple JSON schemas
- Structured Output Guide - Learn about structured outputs
- Create assistant - Create assistant with JSON schemas