API reference
The Inntrig REST API is documented with an interactive Scalar UI, served directly from the API.
Endpoint
Section titled “Endpoint”| Environment | URL |
|---|---|
| Production | https://api-production-02d9.up.railway.app/docs |
| Local | http://localhost:3001/docs |
The raw OpenAPI 3.1 spec is available at /openapi.json on the same host (useful for code generation or tooling).
Authentication
Section titled “Authentication”All protected endpoints require a session cookie. Sign in via POST /auth/sign-in/email to obtain a better-auth.session_token cookie, then include it with subsequent requests. See the MCP server page for instructions on copying the cookie from DevTools.
Endpoint groups
Section titled “Endpoint groups”| Tag | Description |
|---|---|
| Health | GET /health — liveness check |
| Me | Current user profile |
| Standards | Read-only access to audit standards and criteria |
| Projects | Create and manage projects; list audits per project |
| Reports | Create, edit, lock/unlock, export, and manage report results |
| Results | Update criterion result status, notes, and attributes |
| Admin | Staff-only: user management, workspace tiers, standard config |
All list endpoints support pagination via ?limit=N&offset=N query parameters and return { data, total, limit, offset }.
Implementation
Section titled “Implementation”The spec is hand-authored in apps/api/src/openapi.ts and served at runtime — there is no generated file on disk. The Scalar UI is provided by @scalar/hono-api-reference and registered in apps/api/src/index.ts.