Skip to content

API

The Pro-tier web cockpit is built on a Hono application at https://api.basalted.com, running on Cloudflare Workers.

MethodPathWhat
POST/v1/auth/oauth/startBegin GitHub/Google OAuth
GET/v1/meCurrent user
GET/v1/vaultsList registered vaults
POST/v1/vaultsRegister a new vault
POST/v1/briefs/generateGenerate a brief against a registered vault
GET/v1/briefsList recent briefs
GET/v1/briefs/:idFetch a brief
GET/v1/findingsCross-vault finding timeline
POST/v1/billing/checkoutCreate a Stripe Checkout session

Authentication is cookie-based session, set by /v1/auth/oauth/callback. Rate limiting is 60 req/min per session by default; /v1/briefs/generate is 6 req/min.

See reference for the auto-generated OpenAPI spec.