curl --request POST \
--url https://sandbox.rx.tera.health/v1/patient/forms/{form_assignment_id}/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"answers": {
"weight_kg": 96.2,
"primary_goal": "preserve_muscle"
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({answers: {weight_kg: 96.2, primary_goal: 'preserve_muscle'}})
};
fetch('https://sandbox.rx.tera.health/v1/patient/forms/{form_assignment_id}/submit', 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/forms/{form_assignment_id}/submit"
payload = { "answers": {
"weight_kg": 96.2,
"primary_goal": "preserve_muscle"
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "0190f5c3-7e21-7a40-9b11-5d6e7f8091a2",
"form": {
"code": "glp1_onboarding",
"version": 1,
"purpose": "onboarding",
"title": "Coaching Onboarding"
},
"status": "completed",
"blocks_onboarding": true,
"due_at": "2026-10-24T15:00:00Z",
"sent_at": "2026-10-21T15:00:00Z",
"completed_at": "2026-10-22T09:30:00Z",
"fields": [
{
"id": "weight_kg",
"type": "number",
"label": "Current weight",
"unit": "kg",
"required": true
},
{
"id": "primary_goal",
"type": "select",
"label": "Primary goal",
"options": [
"lose_weight",
"preserve_muscle",
"manage_side_effects",
"build_habits"
],
"required": true
}
],
"prefill": {
"weight_kg": 96.2
},
"draft_answers": null,
"answers": {
"weight_kg": 96.2,
"primary_goal": "preserve_muscle"
},
"result": null
}Submit a form
Validates every answer against the fields (required, type, options, range) and completes the form.
When the last blocking form is completed the enrollment moves to onboarding_completed
(onboarding.completed). Answers to health profile questions (allergies, dietary restrictions, activity level,
cooking, lifestyle and so on) update the patient’s profile, readable with GET /v1/patient. An eligibility
form returns its result.
Error codes: validation_failed (422, with a pointer per field such as /answers/weight_kg), form_not_open (409).
Plans: AI + health and fitness coaches (ai_health_fitness), AI only (ai_only).
curl --request POST \
--url https://sandbox.rx.tera.health/v1/patient/forms/{form_assignment_id}/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"answers": {
"weight_kg": 96.2,
"primary_goal": "preserve_muscle"
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({answers: {weight_kg: 96.2, primary_goal: 'preserve_muscle'}})
};
fetch('https://sandbox.rx.tera.health/v1/patient/forms/{form_assignment_id}/submit', 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/forms/{form_assignment_id}/submit"
payload = { "answers": {
"weight_kg": 96.2,
"primary_goal": "preserve_muscle"
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "0190f5c3-7e21-7a40-9b11-5d6e7f8091a2",
"form": {
"code": "glp1_onboarding",
"version": 1,
"purpose": "onboarding",
"title": "Coaching Onboarding"
},
"status": "completed",
"blocks_onboarding": true,
"due_at": "2026-10-24T15:00:00Z",
"sent_at": "2026-10-21T15:00:00Z",
"completed_at": "2026-10-22T09:30:00Z",
"fields": [
{
"id": "weight_kg",
"type": "number",
"label": "Current weight",
"unit": "kg",
"required": true
},
{
"id": "primary_goal",
"type": "select",
"label": "Primary goal",
"options": [
"lose_weight",
"preserve_muscle",
"manage_side_effects",
"build_habits"
],
"required": true
}
],
"prefill": {
"weight_kg": 96.2
},
"draft_answers": null,
"answers": {
"weight_kg": 96.2,
"primary_goal": "preserve_muscle"
},
"result": 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.
Headers
Optional on this action. When sent, it works as on creating requests (24 hours, same body).
8 - 255Path Parameters
Body
Answers keyed by field id.
Show child attributes
Show child attributes
{
"weight_kg": 96.2,
"primary_goal": "preserve_muscle"
}
Response
The completed form.
A form sent to the patient, with its fields, prefill and any saved draft.
"0190f5c3-7e21-7a40-9b11-5d6e7f8091a2"
Show child attributes
Show child attributes
pending, sent, in_progress, completed, expired, cancelled "sent"
Onboarding completes only when every blocking form is completed.
true
Show child attributes
Show child attributes
Values the brand's intake already provided. Show them as defaults.
Show child attributes
Show child attributes
{
"weight_kg": 96.2,
"primary_goal": "preserve_muscle"
}
"2026-10-24T15:00:00Z"
"2026-10-21T15:00:00Z"
null
Answers keyed by field id.
Show child attributes
Show child attributes
{
"weight_kg": 96.2,
"primary_goal": "preserve_muscle"
}
Submitted answers, once completed.
Show child attributes
Show child attributes
{
"weight_kg": 96.2,
"primary_goal": "preserve_muscle"
}
Eligibility forms only, once completed.
Show child attributes
Show child attributes