Needs the Read and write permission.

Body

Send any of targets, preferences and body. A field you leave out keeps its value.

Field	Type	Description
targets	object	A change to your daily targets, from a day on.
preferences	object	Display preferences. Only what you send changes; null clears a field.
body	object	Body measurements. Only what you send changes; null clears a field.

Targets

A change applies from from, and earlier days keep their targets. Add through to change only those days: the day after it goes back to the targets it had. Send values as null to have no targets from from.

Field	Type	Description
from	date	Required. The first day the change applies, usually today. Earlier days keep their targets.
values	object or null	Required. All four targets, or null to have no targets from from.
through	date	The last day the change applies, inclusive. Leave out to keep it from then on.

values needs all four targets:

Field	Type	Description
caloriesKcal	number	Required. Energy, in kcal.
proteinG	number	Required. Protein, in grams.
carbsG	number	Required. Carbohydrates, in grams.
fatG	number	Required. Fat, in grams.

Preferences

Field	Type	Description
units	string or null	The units to show amounts in; imperial is US customary. null follows the phone. One of metric, imperial or uk.
deviceUnits	string	The units the phone uses, as the app last reported them. One of metric, imperial or uk.
showTargets	boolean	Whether the app shows progress towards your targets.
assistantShortcut	string or null	The assistant the app's shortcut opens, or off. One of claude, chatgpt or off.

Body measurements

Field	Type	Description
weightKg	number or null	Weight, in kilograms.
heightCm	number or null	Height, in centimetres.
age	integer or null	Age, in years. From 1 to 130.
sex	string or null	Sex, for estimating energy needs. One of female, male or unspecified.
activity	string or null	How active a usual day is. One of sitting, somewhat or very.

Response

200 with your settings after the change.

Example

curl -X PATCH https://app.splot.health/v1/settings \
  -H "Authorization: Bearer $SPLOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "targets": { "from": "2026-10-06", "values": { "caloriesKcal": 2000, "proteinG": 130, "carbsG": 220, "fatG": 65 } }
  }'