Sign in
advisor-chat

Create a new advisor chat session for the patient with an initial message

post/patients/{patient_id}/advisor-chat/sessions

Path parameters

patient_idinteger required

Query parameters

session_typestring

Request body

client_subject_typestring nullable

Internal-only client classification for analytics/debug (not returned).

contentstring
context_optionsobject nullable
meal_idinteger nullable

Meal id used when start_mode=assistant_meal_reflection.

opening_questionstring nullable

Client-provided opening question used when start_mode=assistant_question.

start_mode'user_message' | 'assistant_question' | 'assistant_meal_reflection' nullable

How this session should start. When set to assistant_question, content is optional and opening_question is required. When set to assistant_meal_reflection, meal_id is required.

subject_idstring nullable
subject_type'general' | 'patient_daily_insight' | 'sms_message' | 'pinned_health_targets' | 'client_prompt' | 'meal_reflection'

Response

successful operation, session created

contentstring required
content_type'text/plain' | 'text/markdown' required
has_follow_up_questionboolean nullable
idinteger required
role'user' | 'assistant' required
session_idinteger required
timestampstring date-time required
titlestring nullable

Changes