Bolka Developer API

Introduction

A public REST API for building on Bolka Connect — manage agents, campaigns, contacts, knowledge bases, and more. Every request is authenticated with an API key.

Base URL

https://api.bolka.ai/developer

All endpoint paths shown in this guide are relative to this base — e.g. GET https://api.bolka.ai/developer/v1/agents.

Authentication

Create an API key in app.bolka.ai → Settings → Developer. Keys look like bk_live_…. Send it on every request in the X-API-Key header:

cURL

curl 'https://api.bolka.ai/developer/v1/ping' \
  -H 'X-API-Key: bk_live_your_key_here'

Treat keys as secrets — never ship them in browser or mobile code. Check the scopes granted to a key with GET /v1/scopes.

Pagination

List endpoints accept page (1-indexed, default 1) and limit (default 20, max 100) query parameters.

Errors

401 — missing or invalid X-API-Key.
403 — the key lacks the scope for this operation.
404 — the resource does not exist or is not visible to your organization.
422 — request validation failed; the body describes the offending fields.
429 — rate limited; retry after a short backoff.