# goals_update

> Update an existing goal's name, description, target, period, or status.

<!-- Source: https://docs.actuallycare.com/tools/goals/goals_update -->
<!-- Last updated: 2026-10-22 -->

Update an existing goal's name, description, target, period, or status. Only provided fields change — omitted fields stay unchanged. Use status="achieved" when the goal is met, "missed" when the period ended short, or "paused" to set it aside. current_value is writable ONLY on a metric="manual" goal. A goal's assignment (who it belongs to) is write-once and cannot be changed here. Returns the updated goal.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `goal_id` | string | Yes | UUID of the goal to update (required). Use [`goals_list`](/tools/goals/goals_list) to find. · Format: UUID |
| `name` | string | No | Updated goal name (max 200 characters) |
| `description` | string | No | Updated description (max 4000 characters) |
| `unit_label` | string | No | Updated unit label (max 24 characters) |
| `target_value` | number | No | Updated target number · Min: 0.01 |
| `current_value` | number | No | Updated current value. ONLY valid on a metric="manual" goal. · Min: 0 |
| `period_type` | enum | No | Updated period length · One of: `weekly`, `monthly`, `quarterly`, `annually`, `custom` |
| `period_start` | string | No | Updated first day of the period (YYYY-MM-DD) (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `period_end` | string | No | Updated last day of the period (YYYY-MM-DD) (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `status` | enum | No | Updated status · One of: `active`, `paused`, `achieved`, `missed` |

## Example prompts

- "Mark my September listings goal as achieved."
- "Raise my Q4 closings target from 12 to 15."

## Safety

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