REST API

Base URL: https://api.dialogbrain.com

Authentication

All requests require an API key:

X-API-Key: db_live_YOUR_KEY_HERE

Pagination

List endpoints accept limit (default 50, max 200) and offset query parameters.

GET /api/v1/conversations?limit=20&offset=40

Error Format

{
  "error": "Human-readable description",
  "error_type": "MACHINE_READABLE_CODE"
}

Common HTTP status codes:

• 400 — Invalid request (see error_type for details)
• 401 — Missing or invalid API key
• 403 — Key doesn't have permission for this workspace
• 404 — Resource not found
• 429 — Rate limited

API Reference

The full endpoint reference is auto-generated from the live OpenAPI spec. See the sidebar for all available endpoints organized by resource.