Named schema definitions for reference.
Contains type definitions that can be referenced throughout the schema
using $ref: "#/$defs/TypeName". Essential for recursive types and
shared structures.
Whether additional properties are allowed.
Always false for function parameters to ensure strict type checking.
This prevents LLMs from hallucinating extra properties.
OptionaldeprecatedWhether this type is deprecated.
When true, indicates the type should no longer be used and may be removed
in future versions. Set via the @deprecated JSDoc tag.
OptionaldescriptionDetailed description of the schema.
Full documentation for the type, explaining its purpose, constraints, and usage. Extracted from JSDoc comment body. Supports markdown formatting in many JSON Schema consumers.
OptionalexampleSingle example value for the schema.
A representative value that conforms to the schema, useful for
documentation and testing. Set via the @example JSDoc tag.
OptionalexamplesNamed example values for the schema.
Multiple examples as key-value pairs, where keys are example names and values are conforming data. Useful for showing different valid states or edge cases.
Property name to schema mapping.
Defines the type of each named property on the object. All properties are defined here regardless of whether they are required or optional.
OptionalreadWhether the property is read-only.
When true, the property should not be modified by clients and is
typically set by the server. Useful for generated IDs, timestamps, etc.
List of required property names.
Properties in this array must be present in the object. In strict mode, all properties become required automatically.
OptionaltitleShort title for the schema.
A brief, human-readable name for the type. Typically extracted from the
first line of a JSDoc comment or the @title tag.
OptionalwriteWhether the property is write-only.
When true, the property is accepted on input but never returned in
responses. Common for sensitive data like passwords.
Function parameters schema with shared type definitions.
Extends the object schema to include a
$defsmap for named type definitions that can be referenced via$ref. This structure allows recursive types and reduces schema duplication.The
additionalPropertiesis alwaysfalsefor parameters to ensure strict argument validation and prevent unexpected properties.