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

# Update Goal Progress

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

Update the progress value of a goal.

- **goal_id**: The ID of the goal to update
- **current_value**: New progress value (query parameter)

## Path parameters

- `goal_id` string, required

## Query parameters

- `current_value` number, required — New progress value

## Response `200`

Successful Response

- DeveloperGoal
  - `created_at` string, date-time, required
  - `current_value` number, required
  - `desired_outcome` string, required
  - `focus_rank` integer, nullable
  - `goal_id` string, required
  - `goal_type` string, required
  - `horizon_at` string, date-time, nullable
  - `id` string, required
  - `is_active` boolean, required
  - `max_value` number, required
  - `metric` GoalMetric
    - `current` number, required
    - `max` number, nullable
    - `min` number, nullable
    - `target` number, required
    - `type` 'boolean' | 'scale' | 'numeric', required
    - `unit` string, nullable
  - `min_value` number, required
  - `source` string, required
  - `status` string, required
  - `success_criteria` string[]
  - `target_value` number, required
  - `title` string, required
  - `unit` string, nullable
  - `updated_at` string, date-time, required
  - `why_it_matters` string, nullable

## 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

> 28 revisions in range; 2 could not be searched.

- **2026-07-10** `f4b8376249bb` — 9 info
  - added the optional property `focus_rank` to the response with the `200` status
  - added the optional property `horizon_at` to the response with the `200` status
  - added the optional property `metric` to the response with the `200` status
  - added the optional property `success_criteria` to the response with the `200` status
  - …5 more
- **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/progress/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/3add0ce9bc4f/schema)