Send a chat message
POST/api/v1/sai/chats/:userId
Creates a new conversation or continues an existing one, and returns the AI's reply along with the chatId. Omit chatId to start a conversation (optionally with customInstructions); include chatId to continue that conversation (customInstructions is then ignored). saiResponse is a JSON-encoded string of content sections — PARAGRAPH text and RESULTS_READ_OUT biomarker results — plus optional productInfo, getSupport, and followUpQuestions fields. The customer (userId is the customer ID returned by the Customers endpoints) must belong to your business, and each call counts toward your subscription's metered SAI usage; list and manage conversations with GET /api/v1/sai/chats.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 500
Message sent successfully
Validation failed
Business session is required
User does not belong to this business or conversation does not belong to this business
User not found or conversation not found (when chatId is provided)
Internal server error