API Documentation

Base URL: https://api.your-domain.com. Below is the v1 reference, auth model, and example responses (200/400/401/403/404/500).

Authentication

Project API Key
Used server-to-server for project operations (issue End-User Token, set persona).
Authorization: Bearer rk_live_xxx
End-User Token
JWT used to perform requests on behalf of a specific end-user within a project (chat, messages, etc.).
Authorization: Bearer <endUserToken>
Recommended: rate limiting + separate keys for test/live.

API Reference (v1)

Click an endpoint to expand params, request/response examples, and HTTP status codes.