API Reference

{
  "tenant_slug": "your-tenant-slug",
  "session_id": "uuid-v4",          // identifies the conversation
  "message": "What are your hours?",
  "language": "en"                   // optional, auto-detected if omitted
}

{
  "reply": "Our hours are Monday–Friday, 9 am to 6 pm.",
  "session_id": "uuid-v4",
  "receipt_id": "rcpt_01J...",       // governance receipt ID
  "pii_detected": false,
  "escalated": false,
  "language": "en",
  "latency_ms": 412
}

{
  "tenant_slug": "your-tenant-slug",
  "session_id": "uuid-v4",
  "message": "Explain your return policy."
}

data: {"token":"Our"}

data: {"token":" return"}

data: {"token":" policy"}

data: {"token":" is"}

data: {"done":true,"receipt_id":"rcpt_01J...","pii_detected":false}

const res = await fetch('/api/proxy/chat-stream', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    tenant_slug: 'your-slug',
    session_id: crypto.randomUUID(),
    message: userInput,
  }),
});

const reader = res.body.getReader();
const decoder = new TextDecoder();
let buffer = '';

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });
  const lines = buffer.split('\n');
  buffer = lines.pop() ?? '';
  for (const line of lines) {
    if (!line.startsWith('data: ')) continue;
    const event = JSON.parse(line.slice(6));
    if (event.token) appendToken(event.token);
    if (event.done) finalise(event);
  }
}

{
  "slug": "your-tenant-slug",
  "name": "Acme Corp",
  "bot_name": "Aria",
  "greeting": "Hi! How can I help you today?",
  "accent_color": "#0077CC",
  "theme": "dark",
  "voice_enabled": false,
  "language": "en",
  "plan": "pro"
}