Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.brama.work/llms.txt

Use this file to discover all available pages before exploring further.

Заповнюється по мірі того як integrations ship’аться. Поточна v0.1 — scaffold-only. Перші tools у brama_ringostat_* namespace будуть додані з Ringostat integration.

​
Tool naming convention

brama_{vendor}_{action}
VendorTools (planned)
ringostatget_missed_calls, get_call_recording, create_callback_task, get_agent_stats
binotelTBD (v0.2 candidate)
basTBD (v0.2 candidate)

​
Request format

Standard MCP request з Bearer auth: 
POST https://api.brama.work/mcp/{tenant_id}
Authorization: Bearer {tenant_api_key}
Content-Type: application/json

{
  "method": "tools/call",
  "params": {
    "name": "brama_ringostat_get_missed_calls",
    "arguments": {
      "date": "2026-05-13",
      "idempotency_key": "<uuid>"
    }
  }
}

​
Response shape

{
  "result": {
    "content": [
      { "type": "text", "text": "<JSON-encoded structured payload>" }
    ]
  }
}
Structured payload schema — per tool у відповідній integration page.

​
Errors

Error codeMeaningRetry safe?
rate_limitedVendor rate limit hityes, з exponential backoff
invalid_tokenTenant vendor token expired/revokedno — re-auth у admin
vendor_5xxVendor API transient erroryes
tenant_not_foundTenant suspended або terminatedno

​
Idempotency

Write operations (анти-pattern: create_*, update_*, delete_*) приймають idempotency_key (UUID). Brama зберігає (tenant_id, key, result_hash) у Supabase — повторні calls з тим самим key повертають cached result без vendor API call. Read operations natively idempotent — idempotency_key ігнорується якщо переданий.