Skip to main content
POST
/
chat
/
message
Send Message
curl --request POST \
  --url https://api.example.com/chat/message

​
POST /chat/message

Send a user message to the Bubba AI assistant and receive a response. This is the primary endpoint for interactive chat within the platform.

​
Notes

  • Requires a write session (workspace write access).
  • The message field is required and must be non-empty.
  • Pass conversation_id to continue an existing conversation, or omit it to start a new one.
  • The optional provider field selects an AI model provider; defaults to the platform default when omitted.
  • Set low_stakes: true for lighter-weight responses where lower latency is preferred over depth.
  • Supports an X-Idempotency-Key header to prevent duplicate message processing on retries.
  • This endpoint proxies through DalyAPI to the Bubba chat service.
  • Response is wrapped in { "result": "success", "data": ... } where data contains the assistant’s reply and conversation metadata.
  • Returns 503 if the chat service is not configured or unavailable.