Public API
The public API and SDK documentation entrypoint.
Source artifacts
Public API artifacts currently live under the repo docs and package tree:
docs/developer/public-api.openapi.jsondocs/developer/llms.txtdocs/developer/cli-commands.jsonpackages/public-api-clientpackages/public-api-mcp
Generation
Use the repository scripts when public API contracts change:
pnpm generate:public-api
pnpm check:public-api-artifacts
pnpm check:public-api-cli
pnpm check:public-api-mcpDocs shape
Public API docs should include:
- Authentication and workspace scoping.
- Endpoint groups and examples.
- SDK and CLI usage.
- Error handling and rate-limit behavior.
- MCP server setup where applicable.