Skip to main content
PATCH
Log daily values

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.

Path Parameters

log_date
string<date>
required

The day, in the patient's time zone.

Body

application/merge-patch+json

JSON Merge Patch (RFC 7396) on one day. Values are the day's totals: send the new total, not an increment. null clears a value. Weight and body measures go here.

water_ml
integer | null
Required range: 0 <= x <= 20000
Example:

1800

weight_kg
number | null
Required range: 20 <= x <= 400
Example:

94.8

waist_cm
number | null
Required range: 30 <= x <= 300
Example:

101.5

hip_cm
number | null
Required range: 30 <= x <= 300
Example:

112

body_fat_pct
number | null
Required range: 1 <= x <= 80
Example:

38.5

steps
integer | null
Required range: 0 <= x <= 200000
Example:

7400

sleep_minutes
integer | null
Required range: 0 <= x <= 1440
Example:

430

sleep_quality
integer | null
Required range: 1 <= x <= 5
mood
integer | null
Required range: 1 <= x <= 5
stress
integer | null
Required range: 1 <= x <= 5
energy
integer | null
Required range: 1 <= x <= 5
habits_done
object

Habit check-offs keyed <protocol_id>:<habit_key>, from the active protocols.

Example:
metrics
object

Any other daily metric, keyed by a metric code. New codes need no API change.

Example:

Response

The day after the change.

log_date
string<date>
required

A calendar date in the patient's time zone.

Example:

"2026-10-26"

habits_done
object
required
Example:
metrics
object
required
Example:
sources
enum<string>[]
required
read-only

Set by the API from the caller. brand_api for brand servers, brand_app for patient tokens issued to a brand.

Available options:
app,
brand_app,
brand_api,
wearable,
coach,
ai,
system
Example:
updated_at
string<date-time>
required

ISO 8601 in UTC.

Example:

"2026-10-26T14:05:00Z"

water_ml
integer | null
Example:

1800

weight_kg
number | null
Example:

94.8

waist_cm
number | null
Example:

null

hip_cm
number | null
Example:

null

body_fat_pct
number | null
Example:

null

steps
integer | null
Example:

7400

sleep_minutes
integer | null
Example:

430

sleep_quality
integer | null
Required range: 1 <= x <= 5
mood
integer | null
Required range: 1 <= x <= 5
stress
integer | null
Required range: 1 <= x <= 5
energy
integer | null
Required range: 1 <= x <= 5
protein_g
number | null
read-only

Rollup of the day's meal logs.

Example:

92.5

calories_kcal
integer | null
read-only
Example:

1450

fiber_g
number | null
read-only
Example:

21

workout_minutes
integer | null
read-only

Rollup of the day's workout logs.

Example:

35

max_symptom_severity
integer | null
read-only

Worst symptom severity logged that day.

Example:

2