List habits
list_habitsReads- What it does
- Reads only. Changes nothing.
- Permission
- Habits, read
habits:read
What your assistant is told
List the user's habits (active by default; pass include_archived=true to
include archived ones). Returns each habit's id, targets, unit, and
cadence — call this first so you have the habit_ids for log_checkin
and the cadence context for coaching.
Each habit carries a sentence stating its rule in plain words. Prefer
it when describing a habit to the user; it is generated from the stored
row and will not drift from how the habit is actually scored.
Parameters
include_archivedtrue or false, optionalInclude archived habits in the result (default false).