API Documentation

Base URL: https://api.your-domain.com. Below is the v1 API reference, authentication, and response examples (200/400/401/403/404/429/500).

Authentication

Project API key
Used for server-to-server project operations (issuing an end-user token, assigning a persona).
Authorization: Bearer rk_live_xxx
End-user token
JWT used to perform requests on behalf of a specific end user within a project (scenarios, chat stream, messages, etc.).
Authorization: Bearer <endUserToken>
Recommended: rate limiting + separate keys for test/live.

API Reference (v1)

Click an endpoint to expand parameters, body examples, and the list of possible HTTP responses.