Pinnate Docs

GitHubApp

Schemas

Version shared JSON Schema documents in the registry.

A schema resource stores JSON Schema documents with the same versioning and visibility model as APIs.

Create and upload

Use Schemas in the console or the REST API under /v1/schemas. Attach git sync to a schema file path when the schema lives in your repo.

When to use schemas

  • Share request/response models across multiple OpenAPI documents

  • Publish standalone schemas for partners without exposing a full API

  • Keep validation artifacts next to OpenAPI in a monorepo