May 19, 2025 — Cortex COMPLETE Structured Output schema references

Snowflake announces support for schema references in Cortex COMPLETE Structured Outputs, making it easier for developers to create and maintain complex schemas. The new $ref mechanism allows developers to define common components once and reference them throughout their schema. This enhancement also unlocks compatibility with third-party libraries like Pydantic that rely on schema references, enabling developers to use existing Pydantic schemas with COMPLETE Structured Outputs.

Key benefits include:

  • Use existing schemas: Streamlined development workflow for Python developers already using Pydantic in their application code.

  • Maintenance simplicity: Change definitions in one place and all references automatically inherit updates.

  • Error reduction: Standardized referenced components eliminate discrepancies across implementations.

  • Scalability: Referenced components allow you to extend functionality without duplicating validation logic

  • Schema clarity: References create a clear, organized hierarchy that better represents real-world relationships.

To get started, see COMPLETE Structured Outputs.