Update my profile

curl --request PATCH \
  --url https://sandbox.rx.tera.health/v1/patient \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/merge-patch+json' \
  --data '
{
  "height_cm": 167.6,
  "units": "metric",
  "health_profile": {
    "dietary_restrictions": [
      "dairy_free",
      "gluten_free"
    ],
    "cooking": {
      "skill": "intermediate"
    }
  }
}
'

const options = {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/merge-patch+json'
  },
  body: JSON.stringify({
    height_cm: 167.6,
    units: 'metric',
    health_profile: {
      dietary_restrictions: ['dairy_free', 'gluten_free'],
      cooking: {skill: 'intermediate'}
    }
  })
};

fetch('https://sandbox.rx.tera.health/v1/patient', 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"

payload = {
    "height_cm": 167.6,
    "units": "metric",
    "health_profile": {
        "dietary_restrictions": ["dairy_free", "gluten_free"],
        "cooking": { "skill": "intermediate" }
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/merge-patch+json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "patient": {
    "first_name": "Jordan",
    "last_name": "Rivera",
    "email": "jordan.rivera@example.com",
    "phone": "+12025550143",
    "date_of_birth": "1986-04-12",
    "sex": "female",
    "height_cm": 167.6,
    "state_code": "NY",
    "timezone": "America/New_York",
    "language": "en",
    "units": "metric",
    "conditions": [
      "prediabetes"
    ],
    "health_profile": {
      "goal_weight_kg": 72.5,
      "activity_level": "lightly_active",
      "food_allergies": [
        "peanuts"
      ],
      "dietary_restrictions": [
        "dairy_free",
        "gluten_free"
      ],
      "food_dislikes": [
        "mushrooms"
      ],
      "cooking": {
        "skill": "intermediate",
        "appliances": [
          "stove_range",
          "microwave",
          "air_fryer"
        ],
        "meal_preparer": "mostly_myself"
      },
      "lifestyle": {
        "sleep_hours": 6.5,
        "alcohol": "occasional",
        "smoking": "never"
      }
    }
  },
  "enrollment": {
    "id": "0190f5c2-3a1b-7c4d-8e9f-a0b1c2d3e4f5",
    "plan_code": "ai_health_fitness",
    "status": "active",
    "stage": "protocols_active",
    "data_sharing": true
  },
  "care_team": [
    {
      "care_role": "health_coach",
      "display_name": "Maya C.",
      "title": "Health Coach",
      "credentials": [
        "RD",
        "NBC-HWC"
      ],
      "assigned_at": "2026-10-21T15:10:00Z"
    }
  ],
  "brand": {
    "display_name": "Demo Brand",
    "primary_color": "#1A5F7A",
    "support": {
      "email": "support@example.com",
      "phone": "+12025550100",
      "url": "https://help.example.com"
    }
  },
  "legal_documents_pending": 0
}

PATCH

patient

Update my profile

curl --request PATCH \
  --url https://sandbox.rx.tera.health/v1/patient \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/merge-patch+json' \
  --data '
{
  "height_cm": 167.6,
  "units": "metric",
  "health_profile": {
    "dietary_restrictions": [
      "dairy_free",
      "gluten_free"
    ],
    "cooking": {
      "skill": "intermediate"
    }
  }
}
'

const options = {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/merge-patch+json'
  },
  body: JSON.stringify({
    height_cm: 167.6,
    units: 'metric',
    health_profile: {
      dietary_restrictions: ['dairy_free', 'gluten_free'],
      cooking: {skill: 'intermediate'}
    }
  })
};

fetch('https://sandbox.rx.tera.health/v1/patient', 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"

payload = {
    "height_cm": 167.6,
    "units": "metric",
    "health_profile": {
        "dietary_restrictions": ["dairy_free", "gluten_free"],
        "cooking": { "skill": "intermediate" }
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/merge-patch+json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "patient": {
    "first_name": "Jordan",
    "last_name": "Rivera",
    "email": "jordan.rivera@example.com",
    "phone": "+12025550143",
    "date_of_birth": "1986-04-12",
    "sex": "female",
    "height_cm": 167.6,
    "state_code": "NY",
    "timezone": "America/New_York",
    "language": "en",
    "units": "metric",
    "conditions": [
      "prediabetes"
    ],
    "health_profile": {
      "goal_weight_kg": 72.5,
      "activity_level": "lightly_active",
      "food_allergies": [
        "peanuts"
      ],
      "dietary_restrictions": [
        "dairy_free",
        "gluten_free"
      ],
      "food_dislikes": [
        "mushrooms"
      ],
      "cooking": {
        "skill": "intermediate",
        "appliances": [
          "stove_range",
          "microwave",
          "air_fryer"
        ],
        "meal_preparer": "mostly_myself"
      },
      "lifestyle": {
        "sleep_hours": 6.5,
        "alcohol": "occasional",
        "smoking": "never"
      }
    }
  },
  "enrollment": {
    "id": "0190f5c2-3a1b-7c4d-8e9f-a0b1c2d3e4f5",
    "plan_code": "ai_health_fitness",
    "status": "active",
    "stage": "protocols_active",
    "data_sharing": true
  },
  "care_team": [
    {
      "care_role": "health_coach",
      "display_name": "Maya C.",
      "title": "Health Coach",
      "credentials": [
        "RD",
        "NBC-HWC"
      ],
      "assigned_at": "2026-10-21T15:10:00Z"
    }
  ],
  "brand": {
    "display_name": "Demo Brand",
    "primary_color": "#1A5F7A",
    "support": {
      "email": "support@example.com",
      "phone": "+12025550100",
      "url": "https://help.example.com"
    }
  },
  "legal_documents_pending": 0
}

Authorizations

Authorization

string

header

default:Bearer sandbox_any_token_works

required

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.

Body

application/merge-patch+json

JSON Merge Patch (RFC 7396). Send only the fields to change.

height_cm

number

The patient's height. Metric, like every measurement; convert from units in the app.

Required range: 50 <= x <= 260

Example:

167.6

timezone

string

Example:

"America/Chicago"

language

string

Example:

"es"

units

enum<string>

Display preference only. The API always takes and returns metric values.

Available options:

metric,

imperial

Example:

"imperial"

Turning it off hides the patient's logs, protocols and AI tools from the care team.

Example:

false

health_profile

object

What plans and the AI Coach are built around. Every field is optional. In a PATCH, send only what changes; null clears a value and [] clears a list.

Show child attributes

Response

The updated profile.

patient

object

required

Show child attributes

enrollment

object

required

Show child attributes

care_team

object[]

required

Empty on ai_only and until coaches are assigned.

Show child attributes

brand

object

required

Show child attributes

legal_documents_pending

integer

Required legal documents not accepted yet. When above 0, show GET /v1/patient/legal-documents first.

Example:

0

Auth

Tenants

Enrollments

Treatment

Consent

Brand logs

Events

Reports

Data requests

Patient

Forms

Logging

Progress

Protocols and plans

Meal swap

Library

Care messaging

Feedback

AI Coach

Reminders

Clinical flags

Webhooks

Update my profile

Authorizations

Body

Response