Log water intake
log_waterAdds- What it does
- Adds a new record and leaves what you had alone. Safe to retry: the same call twice changes nothing more.
- Permission
- Weight and water, change
body:write
What your assistant is told
Log a hydration entry in millilitres at at_iso, which MUST carry the
user's UTC offset — an offsetless timestamp is refused, since the server
would have to guess the zone and the entry could land in the wrong day.
Pass a stable idempotency_key so a retry doesn't double-count. Returns
the saved entry.
Parameters
volume_mlwhole number, requiredVolume in millilitres (positive).at_isotext, requiredWhen logged, ISO-8601 WITH the user's UTC offset (e.g. 2026-06-17T23:30:00+03:00 or 2026-06-17T20:30:00Z). Required; if you don't know their offset, ask.idempotency_keytext, requiredIdempotency key; reuse on retry to avoid double-counting.