Developer Portal · API v2

Build with the Bryka API.

Build, integrate, and scale intelligent chatbots with our REST API. Explore the interactive docs, grab your API key, and start shipping.

Swagger UI Docs Quick Start

Quick Start

Create your first chatbot in seconds. Replace YOUR_API_KEY with a key from the section below.

curl -X POST https://api.bryka.ai/api/chatbots \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Chatbot"}'

Code Examples

Copy-paste examples for the most popular languages and HTTP clients.

curl -X POST https://api.bryka.ai/api/chatbots \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Chatbot"}'

REST API v2

New endpoints are available under /api/v2 with bearer token auth, pagination metadata, and streaming chat.

curl -N -X POST https://api.bryka.ai/api/v2/chatbots/YOUR_CHATBOT_ID/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"Hello","stream":true}'

const response = await fetch(
  'https://api.bryka.ai/api/v2/chatbots/YOUR_CHATBOT_ID/conversations?limit=20',
  { headers: { Authorization: 'Bearer YOUR_API_KEY' } }
);
const data = await response.json();
console.log(data);

Endpoints: GET /api/v2/chatbots, GET /api/v2/chatbots/:id/conversations, POST /api/v2/chatbots/:id/chat, GET /api/v2/chatbots/:id/leads, DELETE /api/v2/conversations/:id.

Your API Keys

Active API keys for your account. Manage keys in Settings → API Keys.

Loading API keys...

Webhook Events Reference

Subscribe to these events to receive real-time notifications at your endpoint. All payloads are delivered as POST requests with a JSON body.

Event	Description	Example Payload
`message.received`	Fired when a new message is received from a visitor.	`{ "event": "message.received", "data": { "conversationId": "...", "message": "...", "sender": "user" } }`
`message.sent`	Fired when the chatbot sends a reply to the visitor.	`{ "event": "message.sent", "data": { "conversationId": "...", "message": "...", "sender": "bot" } }`
`conversation.started`	Fired when a new conversation session begins.	`{ "event": "conversation.started", "data": { "conversationId": "...", "startedAt": "..." } }`
`conversation.ended`	Fired when a conversation session ends or times out.	`{ "event": "conversation.ended", "data": { "conversationId": "...", "endedAt": "...", "messageCount": 12 } }`
`lead.submitted`	Fired when a visitor submits their contact information.	`{ "event": "lead.submitted", "data": { "leadId": "...", "email": "...", "name": "..." } }`
`feedback.created`	Fired when a visitor leaves feedback or a rating.	`{ "event": "feedback.created", "data": { "conversationId": "...", "rating": 5, "comment": "..." } }`

Rate Limits

Rate limits are applied per API key. When a limit is exceeded the API returns 429 Too Many Requests.

Plan	Rate Limit	Burst Limit	Daily Cap
Free	60 req/min	10 req/sec	5,000 req/day
Pro	300 req/min	50 req/sec	50,000 req/day
Enterprise	1,000 req/min	200 req/sec	Unlimited

Rate Limit Response Headers

X-RateLimit-Limit: 300        # Maximum requests per window
X-RateLimit-Remaining: 274    # Remaining requests in current window
X-RateLimit-Reset: 1708700000 # Unix timestamp when the window resets
Retry-After: 12               # Seconds to wait (only on 429 responses)

Chat Widget SDK

Embed the Bryka AI chat widget on any website with a single script tag. Customize appearance through data attributes or the JavaScript API.

<!-- Bryka AI Chat Widget -->
<script
  src="https://cdn.bryka.ai/widget.js"
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-theme="light"
  async
></script>

Download widget.js Widget API Reference

Changelog

Recent changes, improvements, and additions to the Bryka AI API.

v2.5.02026-02-20

New export formats (CSV, JSON) for conversation history.

v2.4.02026-02-10

Introduced webhook signature verification with HMAC-SHA256. Added retry logic for failed webhook deliveries.

v2.3.02026-01-28

New contacts API with custom attributes support. Bulk import/export endpoints for contacts management.

v2.2.02026-01-15

Added predictive suggestions API for real-time query completion. Rate limit headers now included in all responses.

v2.1.02026-01-05

Launched API key scopes and granular permissions. Support for key rotation without downtime.