Developer
Chatbot API Reference
Build custom chatbot integrations.
Endpoints
| Method | Path | Purpose |
|---|---|---|
| POST | /api/cxo/config | Widget or custom client handshake. |
| POST | /api/cxo/chatbot | Submit a user message. |
| GET | /api/cxo/history | Poll session history. |
| GET | /api/cxo/stream | Stream/poll accepted run output for widget sessions. |
| GET/POST | /api/cxo/api-keys | Manage API keys from the dashboard/server side. |
| GET | /api/cxo/analytics | Review usage and quality. |
Use product-scoped keys for external products. The config handshake exchanges a scoped key for a short-lived widget JWT; /api/cxo/chatbot still accepts direct API-key fallback for backward compatibility. Use management endpoints only from authenticated dashboard or trusted server code.