Pinnate Docs

GitHubApp

Registry overview

Version OpenAPI, schemas, and rulesets for humans and machines.

Registry

The registry stores versioned API documents and related artifacts:

Resource

Format

Typical use

API

OpenAPI 3.x

Source of truth for docs embeds and SDK generation

Schema

JSON Schema

Shared models across APIs

Ruleset

Spectral

Lint uploads; optionally block bad publishes

Public vs private

Each resource has visibility. Public documents are readable on registry hosts; private documents require authorization.

Git and console

Upload in the console, via REST/MCP, or connect git sync so merges update the registry automatically.

Guides

Embed a published API in a site: OpenAPI embed.