Overview
POLST REST API (2.0.0)
Section titled “POLST REST API (2.0.0)”Public REST surface for the POLST platform, mounted at /api/rest/v1.
This document is auto-generated from the route definitions in apps/backend/src/rest/. Do not hand-edit. Regenerate with bun run openapi:generate from apps/backend/.
- OpenAPI version: 3.1.0
Authentication
Section titled “ Authentication ”bearerAuth
Section titled “bearerAuth ”Brand API key issued via POL-570/POL-571. Pass in the Authorization: Bearer <key> header.
Security scheme type: http
Bearer format: POL-API-KEY
apiKeyId
Section titled “apiKeyId ”Trusted App API key id (format pol_tai_<24 base64url>). Issued alongside the secret via the TAI admin flow; paired with X-API-Key-Secret on /auth/* endpoints.
Security scheme type: apiKey
Header parameter name: X-API-Key-ID
apiKeySecret
Section titled “apiKeySecret ”Trusted App API key secret (64 hex chars). Never logged, never echoed. Paired with X-API-Key-ID.
Security scheme type: apiKey
Header parameter name: X-API-Key-Secret