Loki Docs
Tools › Profile › Update habits profile

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 | unsure
  • experiencetext, optionalfirst-timer | some-tries | seasoned
  • focusAreatext, optionalwork-productivity | health-fitness | mindfulness | learning | home-life | mixed
  • reminderPreferencetext, optionaloff | gentle | assertive
  • weekStarttext, optionalmonday | sunday | saturday
  • timeZonetext, 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 omits tz, so set it when the user moves.
  • dailyCheckinTimetext, optionalmorning | midday | evening | bedtime | no-preference
  • birthYearwhole 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.