Topic

JSON Schema

4 min read

Reusable JSON Schema components in OpenAPI: DRY models without $ref spaghetti

Inline every schema and your request and response models drift apart. Extract everything and the document becomes a maze of one-off references. The middle path is a small set of rules for what becomes a component, what stays inline, and how to name and compose it.

Read article
4 min read

LLM Structured Outputs and JSON Schema: Tool Calling That Never Drifts

Free-form tool arguments are where agent workflows break: the model invents fields, sends numbers as strings, and omits required values. Structured outputs backed by strict JSON Schema make tool calls deterministic, and most of that schema already exists in your OpenAPI components.

Read article