Base URL
Endpoint categories
SDK ingestion API
Authenticated with an API key (ob_live_...), passed as a Bearer token. Use this from your chatbot integration to send conversation data to OpenBat.
Dashboard API
Authenticated with a Supabase session cookie, established through the web login flow. These endpoints power the OpenBat dashboard and are available for programmatic access. All dashboard endpoints enforce organization-level row-level security — you can only access data that belongs to your organization.API key format
ob_live_a1b2c3 (roughly the first 14 characters) is stored in the dashboard for identification. The full key is hashed with SHA-256 before storage — only the hash is persisted. The full key is returned once at creation or rotation and cannot be recovered.
Rate limits and constraints
| Endpoint | Limit |
|---|---|
POST /api/v1/capture | 1-100 messages per request |
GET /api/v1/conversations | Max page size: 100 |
GET /api/v1/analytics/sentiment | Max lookback: 365 days |
Endpoint overview
| Endpoint | Method | Auth | Description |
|---|---|---|---|
/api/v1/capture | POST | API Key | Ingest conversation messages |
/api/v1/chatbots | GET | Session | List chatbots |
/api/v1/chatbots | POST | Session | Create chatbot |
/api/v1/chatbots/:id | GET | Session | Get chatbot |
/api/v1/chatbots/:id | PATCH | Session | Update chatbot |
/api/v1/chatbots/:id | DELETE | Session | Delete chatbot |
/api/v1/chatbots/:id/rotate-key | POST | Session | Rotate API key |
/api/v1/conversations | GET | Session | List conversations |
/api/v1/conversations/:id | GET | Session | Get conversation detail |
/api/v1/analytics/overview | GET | Session | Aggregate metrics |
/api/v1/analytics/sentiment | GET | Session | Sentiment trends |