Update habits profile
update_profileChanges- What it does
- Changes or deletes something you had. Your assistant can ask you to confirm first. Safe to retry: the same call twice changes nothing more.
- Permission
- Profile, change
profile:write
What your assistant is told
Update one or more fields on the calling user's Habits profile. Sparse patch - only pass fields you want to change; omitted fields are left alone. Idempotent. Use this when the user tells you something durable about how they want the tracker to feel ("switch me to gentle reminders", "my week starts on Sunday now", "I moved to Berlin"). Do NOT use this to create or edit specific habits or check-ins - those have their own tools. Listed fields accept only the values shown; a value outside a list or range rejects the whole call (nothing is saved) with an error naming the field. Returns the profile after the patch.
Parameters
primaryGoaltext, optionalbuild-consistency | break-a-bad-habit | improve-wellbeing | learn-skill | unsureexperiencetext, optionalfirst-timer | some-tries | seasonedfocusAreatext, optionalwork-productivity | health-fitness | mindfulness | learning | home-life | mixedreminderPreferencetext, optionaloff | gentle | assertiveweekStarttext, optionalmonday | sunday | saturdaytimeZonetext, optionalIANA time-zone id, e.g. Europe/Bucharest. Must be a real zone id - an unknown one is rejected, not stored. This is the zone the server buckets check-ins and streaks into whenever a call omitstz, so set it when the user moves.dailyCheckinTimetext, optionalmorning | midday | evening | bedtime | no-preferencebirthYearwhole number, optionalFour-digit year, e.g. 1990. 1900 to the current year.notestext, optionalFree text (~500 chars) - anything the coach should know. Replace the whole note when set. At most 2000 characters.dayStartOffsetMinuteswhole number, optionalWhen the user's logical day rolls over, in minutes past local midnight (0-240; 0 = plain midnight, 120 = 2am). Late-night check-ins before the rollover count for the previous day. Set this when a night owl says late-night activity should count for the day that just ended, e.g. "I go to bed around 1am" -> 120. Talk in rollover time, not raw minutes.