Set the maintenance estimate
set_maintenanceChanges- What it does
- Changes or deletes something you had. Your assistant can ask you to confirm first.
- Permission
- Targets, change
targets:write
What your assistant is told
Record your estimate of the user's maintenance energy — roughly what they
burn in a day — effective from a date (today unless effective_on says
otherwise). Returns the saved estimate.
This is YOUR estimate, not a measurement. Nothing on the server computes
it, and nothing else will correct it. Revise it when the weight trend
stops agreeing with what they are eating: if intake has been steady and
weight is flat, the previous estimate was too low, and vice versa.
Do NOT assume it changes their goals. Targets carry their own absolute
bounds and are untouched by this — if the user's plan should change too,
call set_target as well and say so.
Read get_weights and get_macro_summary before revising — and
get_energy_expenditure when the user has shared their measured energy
burn, which is the best single input you will get — and always
pass a note: earlier estimates stay in the record, and the user sees
this series as a chart of how their maintenance has moved.
Parameters
energy_kcalwhole number, requiredEstimated maintenance energy, kcal per day.effective_ontext, optionalLocal date this estimate takes effect, yyyy-MM-dd. Defaults to today.notetext, optionalWhy you revised it, one short sentence. Shown to the user alongside the number.