# habits_update

> Update an existing habit's name, cadence, status, tagline, or weekly target.

<!-- Source: https://docs.actuallycare.com/tools/habits/habits_update -->

Update an existing habit's name, cadence, status, tagline, or weekly target. Only provided fields are updated — omitted fields stay unchanged. Use status='paused' to pause a habit or status='active' to resume. Returns the updated habit.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `habit_id` | string | Yes | UUID of the habit to update (required). Use [`habits_list`](/tools/habits/habits_list) to find. · Format: UUID |
| `name` | string | No | Updated habit name |
| `cadence` | enum | No | Updated cadence · One of: `daily`, `weekly`, `monthly` |
| `status` | enum | No | Updated status · One of: `active`, `paused`, `archived` |
| `weekly_target` | number | No | Updated weekly target · Max: 7 · Min: 1 |
| `tagline` | string | No | Updated tagline |

## Example prompts

- "Update one of my habits."

## Safety

**Updates data.** Changes an existing record. The change is visible immediately in the app and can be edited back.