Get the AI Coach's reply
curl --request GET \
--url https://sandbox.rx.tera.health/v1/patient/ai-coach/messages/{message_id}/reply \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.rx.tera.health/v1/patient/ai-coach/messages/{message_id}/reply', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://sandbox.rx.tera.health/v1/patient/ai-coach/messages/{message_id}/reply"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"reply_to_message_id": "0190f5cc-4d5e-7f60-8172-8b9c0d1e2f34",
"status": "completed",
"message": {
"id": "0190f5cc-5e6f-7071-9283-9c0d1e2f3a45",
"conversation_id": "0190f5cc-3c4d-7e5f-8061-7a8b9c0d1e23",
"sender": {
"type": "ai",
"display_name": "AI Coach",
"care_role": null
},
"body": "Try a chicken and quinoa bowl tonight. It keeps you near 38 g of protein.",
"created_at": "2026-10-26T11:01:30Z",
"edited_at": null,
"deleted": false,
"seen_by_other_side": false,
"attachment": null,
"reactions": [],
"feedback": null
},
"escalation": null,
"show_emergency_guidance": false
}AI Coach
Get the AI Coach's reply
message_id is the patient’s message. Two ways to read the reply:
- Poll with
Accept: application/jsonevery 1-2 seconds untilstatusiscompletedorfailed. - Stream with
Accept: text/event-stream(Server-Sent Events). Events:delta({"text": "..."}, the next piece of the reply), then onecompletedwith the fullAiCoachReply, orerrorwith a problem document. Guardrails run before text is streamed, so a blocked reply never streams.
Plans: AI + health and fitness coaches (ai_health_fitness), AI only (ai_only).
GET
/
v1
/
patient
/
ai-coach
/
messages
/
{message_id}
/
reply
Get the AI Coach's reply
curl --request GET \
--url https://sandbox.rx.tera.health/v1/patient/ai-coach/messages/{message_id}/reply \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.rx.tera.health/v1/patient/ai-coach/messages/{message_id}/reply', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://sandbox.rx.tera.health/v1/patient/ai-coach/messages/{message_id}/reply"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"reply_to_message_id": "0190f5cc-4d5e-7f60-8172-8b9c0d1e2f34",
"status": "completed",
"message": {
"id": "0190f5cc-5e6f-7071-9283-9c0d1e2f3a45",
"conversation_id": "0190f5cc-3c4d-7e5f-8061-7a8b9c0d1e23",
"sender": {
"type": "ai",
"display_name": "AI Coach",
"care_role": null
},
"body": "Try a chicken and quinoa bowl tonight. It keeps you near 38 g of protein.",
"created_at": "2026-10-26T11:01:30Z",
"edited_at": null,
"deleted": false,
"seen_by_other_side": false,
"attachment": null,
"reactions": [],
"feedback": null
},
"escalation": null,
"show_emergency_guidance": false
}Authorizations
A 15-minute token bound to one patient and one enrollment, issued by POST /v1/oauth/token with the
token-exchange grant. Treat it as opaque. When it expires, exchange a fresh assertion; there is no refresh token.
Path Parameters
Response
The reply's state, or the stream.
Example:
"0190f5cc-4d5e-7f60-8172-8b9c0d1e2f34"
Available options:
pending, running, completed, failed Example:
"completed"
When true, show the 911 and 988 guidance above the reply.
Example:
false
The AI Coach's reply, once completed.
Show child attributes
Show child attributes
The AI Coach handed this message to a human. notice is what to show the patient.
Show child attributes
Show child attributes