---
title: "Update an existing goal progress"
method: PATCH
path: "/v1/org/{orgId}/goal-progress/{goalProgressId}"
tags: ["goalProgress"]
---

# Update an existing goal progress

`PATCH /v1/org/{orgId}/goal-progress/{goalProgressId}`

## Path parameters

- `orgId` string, required
- `goalProgressId` string, required

## Request body

- UpdateGoalProgress
  - `goalId` string — goal id that this progress update belongs to
  - `actuals` GoalTargetActual[] — manually entered values for the current actual progress towards the goal target(s)
    - `goalTargetId` string, required
    - `value` union
      - string
      - number
      - boolean
  - `forecasts` GoalProgressForecast[] — forecasts for where the goal target(s) will be as-of the end date
    - `goalTargetId` string, required
    - `type` 'WORST' | 'COMMIT' | 'CALL' | 'LIKELY' | 'BEST', required
    - `label` string
    - `value` union, required
      - string
      - number
      - boolean
    - `labelTr` Translations
      - `values` object, required
  - `confidence` integer — confidence level of the progress update on how overall on-track we are for the goal as whole, on a scale of 0 to 100
  - `done` integer — if marking the goal done, how accomplished the goal was, on a scale of 0 to 100
  - `comment` string — comment on the progress update
  - `date` string, date — effective date of this progress update

## Response `200`

updated

- GoalProgress
  - `id` string, required — globally unique id
  - `orgId` string, required — parent organization id
  - `goalId` string, required — goal id that this progress update belongs to
  - `actuals` GoalTargetActual[] — manually entered values for the current actual progress towards the goal target(s)
    - `goalTargetId` string, required
    - `value` union
      - string
      - number
      - boolean
  - `forecasts` GoalProgressForecast[] — forecasts for where the goal target(s) will be as-of the end date
    - `goalTargetId` string, required
    - `type` 'WORST' | 'COMMIT' | 'CALL' | 'LIKELY' | 'BEST', required
    - `label` string
    - `value` union, required
      - string
      - number
      - boolean
    - `labelTr` Translations
      - `values` object, required
  - `confidence` integer — confidence level of the progress update on how overall on-track we are for the goal as whole, on a scale of 0 to 100
  - `done` integer — if marking the goal done, how accomplished the goal was, on a scale of 0 to 100
  - `comment` string — comment on the progress update
  - `date` string, date — effective date of this progress update
  - `createId` string, required — created by user id
  - `createBehalfId` string — created on behalf of user id
  - `createAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `createAt` string, required — created timestamp
  - `updateId` string — last updated by user id
  - `updateBehalfId` string — last updated on behalf of user id
  - `updateAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `updateAt` string — last updated timestamp
  - `deleteId` string — deleted by user id
  - `deleteBehalfId` string — deleted on behalf of user id
  - `deleteAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `deleteAt` string — deleted timestamp

## Other responses

- `400` — invalid data
- `401` — not authorized
- `403` — permission denied
- `404` — not found

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/versions/50a1edd6b27e/schema)