Reference
HTTP API
The API is served under /api/v1. Public endpoints need no credentials; everything else takes a bearer token.
Public endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /health | Liveness check |
| POST | /public/chatbot/:publicId/chat | Ask a chatbot a question |
| GET | /admin/pricing/public | Active pricing plans |
Authenticated endpoints
Send the token from sign-in as a bearer header:
curl https://your-domain.com/api/v1/chatbots \
-H "Authorization: Bearer YOUR_TOKEN"| Method | Path | Purpose |
|---|---|---|
| GET | /chatbots | List your chatbots |
| POST | /chatbots | Create a chatbot |
| GET | /chatbots/:id | One chatbot, with its sources |
| POST | /chatbots/:id/sources/url | Add a website source |
| POST | /chatbots/:id/sources/file | Upload a document |
| POST | /chatbots/:id/chat/stream | Ask, with streamed tokens |