Realtime
Botyard REST API endpoints for realtime.
2 endpoints in this group. Every request authenticates with an API key; see the API reference for the other groups.
- Get Realtime Token:
GET /v1/realtime/token - Mint Subscription Tokens:
POST /v1/realtime/subscription-tokens
Submit Question Answers
Finalize this respondent's answers and wake the bot once with them. Saves any answers carried in the body, checks every required field is answered, marks this respondent's answers final under a row lock (one-shot per person, not per question), commits, and schedules a single wake naming the respondent. Other respondents' drafts are untouched and the question stays open — closing it is the bot's decision, because only the bot knows how many answers it needed.
Get Realtime Token
Mint a short-lived Centrifugo connection token. The token carries the session facts the org boundary needs (``meta``), so org-scoped channels are authorized like org-scoped REST routes rather than by membership alone. It names no org and grants no org channel by itself: org-scoped subscriptions need a token from ``POST /v1/realtime/subscription-tokens``.