API

REST API reference

All endpoints are versioned under /api/v1, return a consistent JSON envelope, and accept a Bearer JWT or API key.

Authentication

POST/auth/registerCreate an account
POST/auth/loginSign in with email and password
POST/auth/googleSign in with a Google identity credential
POST/auth/refreshExchange a refresh token for a new access token
POST/auth/logoutRevoke the current refresh token
GET/auth/meGet the current authenticated user

Chatbots

GET/botsList your chatbots
POST/botsCreate a chatbot
GET/bots/{uuid}Get a chatbot
PUT/bots/{uuid}Update a chatbot
DELETE/bots/{uuid}Delete a chatbot
GET/bots/{uuid}/knowledge-sourcesList knowledge sources
POST/bots/{uuid}/knowledge-sources/websiteCrawl a website as a knowledge source
GET/bots/{uuid}/conversationsList conversations
GET/bots/{uuid}/analyticsGet bot analytics

Webhooks

GET/webhooks/eventsList supported event types
GET/webhooksList your webhooks
POST/webhooksRegister a webhook endpoint
PUT/webhooks/{uuid}Enable or disable a webhook
DELETE/webhooks/{uuid}Remove a webhook
GET/webhooks/{uuid}/logsView delivery logs

Public widget

GET/widget/{botUuid}/configGet public bot + widget configuration
POST/widget/{botUuid}/messagesSend a visitor message
POST/widget/{botUuid}/messages/streamSend a message with a streamed response
POST/widget/{botUuid}/leadsCapture a lead

Billing & teams

GET/subscriptions/plansList available plans
GET/subscriptions/currentGet your current subscription
POST/teams/{uuid}/inviteInvite a team member
POST/api-keysCreate an API key