OpenAPI specification

Machine-readable OpenAPI 3.1 description of the full PandaStack REST API — generate clients, import into Postman, or explore interactively.

The complete PandaStack REST API (144 operations) is described in OpenAPI 3.1, served by the API itself:

https://api.pandastack.ai/openapi.json

The spec is embedded in the API binary and kept honest by a CI drift test that fails the build whenever a registered route is missing from the spec (or vice versa) — what you generate from is what actually runs.

Use it

Postman / Insomnia — import the URL directly (File → Import → Link).

Interactive explorer — paste the URL into any hosted explorer, e.g. Scalar or editor.swagger.io.

Generate a typed client in any language:

# TypeScript (or use the official @pandastack/sdk)
npx openapi-typescript https://api.pandastack.ai/openapi.json -o pandastack.d.ts

# Go
go run github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen@latest \
  -generate types,client -package pandastack \
  https://api.pandastack.ai/openapi.json

# Python (or use the official pandastack package)
pipx run openapi-python-client generate --url https://api.pandastack.ai/openapi.json

Authentication — every operation (unless marked public) takes Authorization: Bearer pds_...; create tokens in the dashboard under API Tokens.

For hand-written reference with narrative context, see the REST API reference. For officially supported clients, prefer the TypeScript and Python SDKs.

Use it

On this page