SDKs & Client Libraries

Official Permissio SDKs are in active development. While packages are not yet available on npm or PyPI, you can generate a fully typed client from the public OpenAPI spec today using any standard code generator.

SDK Status

Language	Status
TypeScript / Node.js	Source available — npm package (@permissio/sdk) coming soon
Python	Source available — PyPI package (permissio) coming soon
Go	Planned — not yet in active development

Public Spec Endpoints

The partner spec is freely accessible — no authentication required, CORS: *:

Format	URL
JSON	https://api.permissio.us/api/openapi/public.json
YAML	https://api.permissio.us/api/openapi/public.yaml

Generate a Client

TypeScript / Node.js

@hey-api/openapi-ts produces a fully typed TypeScript client with fetch-based calls:

npx @hey-api/openapi-ts \
  -i https://api.permissio.us/api/openapi/public.json \
  -o ./src/permissio

Python

openapi-python-client generates an async Python client:

pip install openapi-python-client
openapi-python-client generate \
  --url https://api.permissio.us/api/openapi/public.json

Go

oapi-codegen generates idiomatic Go types and a client:

go install github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen@latest
oapi-codegen -generate types,client \
  https://api.permissio.us/api/openapi/public.json > permissio.gen.go

Official SDK Roadmap

When released, official packages will include idiomatic API design, built-in retry logic, and full type coverage. They will be available at:

• npm: @permissio/sdk
• PyPI: permissio

Follow the changelog for release announcements.