---
title: "Update Goal"
method: PATCH
path: "/v1/dev/user/goals/{goal_id}"
tags: ["Goals"]
---

# Update Goal

`PATCH /v1/dev/user/goals/{goal_id}`

Update a goal.

- **goal_id**: The ID of the goal to update
- **title**: New title (optional)
- **target_value**: New target value (optional)
- **current_value**: New progress value (optional)
- **min_value**: New minimum value (optional)
- **max_value**: New maximum value (optional)
- **unit**: New unit label (optional)

## Path parameters

- `goal_id` string, required

## Request body

- UpdateGoalRequest
  - `current_value` number, nullable — New progress value
  - `max_value` number, nullable — New maximum value
  - `min_value` number, nullable — New minimum value
  - `target_value` number, nullable — New target value
  - `title` string, nullable — New title
  - `unit` string, nullable — New unit label

## Response `200`

Successful Response

- DeveloperGoal
  - `created_at` string, date-time, required
  - `current_value` number, required
  - `goal_type` string, required
  - `id` string, required
  - `is_active` boolean, required
  - `max_value` number, required
  - `min_value` number, required
  - `target_value` number, required
  - `title` string, required
  - `unit` string, nullable
  - `updated_at` string, date-time, required

## Other responses

- `401` — Missing or invalid authentication credentials.
- `403` — Authenticated, but the token does not grant the required scope.
- `404` — Requested resource was not found.
- `422` — Validation Error

## Changes

- **2026-06-30** `c2ab717efdbc` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-30** `c2ab717efdbc` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-30** `c2ab717efdbc` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Full history](https://skmtc.dev/basedhardware/apis/omi-developer-api/changes/v1/dev/user/goals/:goal_id/patch.md)

---

[API](https://skmtc.dev/basedhardware/apis/omi-developer-api.md) · [All operations](https://skmtc.dev/basedhardware/apis/omi-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/basedhardware/omi-developer-api/revisions/c2ab717efdbc/schema)