Bolrach Chat API

A tenant-keyed chat platform you integrate into your product. Channels, members, messages, and realtime delivery over Server-Sent Events. Machine spec: /openapi.json.

Authenticate

Every /v1 call needs your API key:

Authorization: Bearer sk_live_xxxxxxxx

Create a channel

curl -X POST https://chat.bolrach.com/v1/channels \
  -H "Authorization: Bearer sk_live_..." -H "content-type: application/json" \
  -d '{"slug":"general","name":"General"}'

Post a message

curl -X POST https://chat.bolrach.com/v1/channels/CHANNEL_ID/messages \
  -H "Authorization: Bearer sk_live_..." -H "content-type: application/json" \
  -d '{"user_ref":"u_123","display_name":"Ada","body":"hello"}'

Subscribe to realtime (SSE)

const es = new EventSource("https://chat.bolrach.com/v1/channels/CHANNEL_ID/stream", { withCredentials:false });
es.addEventListener("message", e => console.log(JSON.parse(e.data)));

List channels GET /v1/channels   members /v1/channels/{id}/members   messages /v1/channels/{id}/messages. Rate limit 120 req / 10s per key.