Get a feedback popup
curl --request GET \
--url https://sandbox.rx.tera.health/v1/patient/feedback-requests/{feedback_request_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.rx.tera.health/v1/patient/feedback-requests/{feedback_request_id}', 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/feedback-requests/{feedback_request_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "0190f5e3-4c5d-7e6f-8a90-b1c2d3e4f5a6",
"status": "requested",
"care_role": "health_coach",
"coach": {
"care_role": "health_coach",
"display_name": "Maya C.",
"title": "Health Coach",
"credentials": [
"RD"
],
"assigned_at": "2026-09-15T10:00:00Z"
},
"survey": {
"code": "coach_feedback",
"version": 1,
"title": "How is coaching going?",
"intro": "It takes less than a minute.",
"questions": [
{
"key": "overall",
"kind": "rating",
"label": "How would you rate your coach so far?",
"required": true,
"scale_max": 5
},
{
"key": "helpful",
"kind": "thumbs",
"label": "Did your coach help you this month?",
"required": false
},
{
"key": "more_help_with",
"kind": "choice",
"label": "What would you like more help with?",
"required": false,
"options": [
{
"value": "nutrition",
"label": "Nutrition"
},
{
"value": "exercise",
"label": "Exercise"
},
{
"value": "side_effects",
"label": "Side effects"
},
{
"value": "motivation",
"label": "Motivation"
}
]
},
{
"key": "comment",
"kind": "text",
"label": "Anything else you would like to share?",
"required": false,
"max_length": 1000
}
]
},
"requested_at": "2026-10-27T15:00:00Z",
"expires_at": "2026-11-10T15:00:00Z",
"answers": null,
"answered_at": null
}
Feedback
Get a feedback popup
The popup’s title, questions and the coach it is about. TeraRx writes the questions; render each one by its
kind. Don’t show a popup whose status is no longer requested.
Plans: AI + health and fitness coaches (ai_health_fitness).
GET
/
v1
/
patient
/
feedback-requests
/
{feedback_request_id}
Get a feedback popup
curl --request GET \
--url https://sandbox.rx.tera.health/v1/patient/feedback-requests/{feedback_request_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.rx.tera.health/v1/patient/feedback-requests/{feedback_request_id}', 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/feedback-requests/{feedback_request_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "0190f5e3-4c5d-7e6f-8a90-b1c2d3e4f5a6",
"status": "requested",
"care_role": "health_coach",
"coach": {
"care_role": "health_coach",
"display_name": "Maya C.",
"title": "Health Coach",
"credentials": [
"RD"
],
"assigned_at": "2026-09-15T10:00:00Z"
},
"survey": {
"code": "coach_feedback",
"version": 1,
"title": "How is coaching going?",
"intro": "It takes less than a minute.",
"questions": [
{
"key": "overall",
"kind": "rating",
"label": "How would you rate your coach so far?",
"required": true,
"scale_max": 5
},
{
"key": "helpful",
"kind": "thumbs",
"label": "Did your coach help you this month?",
"required": false
},
{
"key": "more_help_with",
"kind": "choice",
"label": "What would you like more help with?",
"required": false,
"options": [
{
"value": "nutrition",
"label": "Nutrition"
},
{
"value": "exercise",
"label": "Exercise"
},
{
"value": "side_effects",
"label": "Side effects"
},
{
"value": "motivation",
"label": "Motivation"
}
]
},
{
"key": "comment",
"kind": "text",
"label": "Anything else you would like to share?",
"required": false,
"max_length": 1000
}
]
},
"requested_at": "2026-10-27T15:00:00Z",
"expires_at": "2026-11-10T15:00:00Z",
"answers": null,
"answered_at": null
}
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 popup.
Example:
"0190f5e3-4c5d-7e6f-8a90-b1c2d3e4f5a6"
Available options:
requested, answered, dismissed, expired Example:
"requested"
A care role on the coached plan. Today health_coach or fitness_coach; more may be added.
Pattern:
^[a-z][a-z0-9_]*$Example:
"health_coach"
The coach the feedback is about, as the patient sees them.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
ISO 8601 in UTC.
Example:
"2026-10-26T14:05:00Z"
After this the popup can't be answered; don't show it.
Example:
"2026-11-23T00:00:00Z"
Set once answered.
Show child attributes
Show child attributes
Example:
{ "overall": 5, "helpful": "up", "more_help_with": "side_effects", "comment": "Maya's tips for nausea made a real difference." }
Example:
null