---
title: "Update an existing goal target"
method: PATCH
path: "/v1/org/{orgId}/goal/{goalId}/target/{goalTargetId}"
tags: ["goalTarget"]
---

# Update an existing goal target

`PATCH /v1/org/{orgId}/goal/{goalId}/target/{goalTargetId}`

## Path parameters

- `orgId` string, required
- `goalId` string, required
- `goalTargetId` string, required

## Request body

- UpdateGoalTarget
  - `goalId` string — goal id that this target belongs to
  - `label` string — human-readable name of the goal target
  - `labelTr` Translations
    - `values` object, required
  - `slug` string — url-safe slug for the goal target, auto-generated from goal slug and label if not provided
  - `startValue` union — starting point value for this target, as-of the date of the goal
    - string
    - number
    - boolean
  - `targetValues` GoalTargetValue[] — potential target values we're working to achieve
    - `targetValueTypeId` string — the type of the target value (for example, 'Stretch' vs 'Minimum'), extracted from the goal type's targetValues
    - `value` union, required — target value to achieve (should be a numeric value, either number, money, or percentage)
      - string
      - number
      - boolean
  - `direction` 'MINIMIZE' | 'MAXIMIZE' | 'TARGET' — direction of the target -- whether we want to minimize or maximize the value
  - `type` 'MILESTONE' | 'MONEY' | 'PERCENT' | 'INTEGER' | 'DECIMAL' — type of the target value
  - `valueExpr` string — Carrot expression used to compute the current value versus target -- if not provided, GoalProgress will be used to track progress
  - `startDate` string, date — start date for this goal target
  - `endDate` string, date — end date for this goal target

## Response `200`

updated

- GoalTarget
  - `id` string, required — globally unique id
  - `orgId` string, required — parent organization id
  - `goalId` string, required — goal id that this target belongs to
  - `label` string — human-readable name of the goal target
  - `labelTr` Translations
    - `values` object, required
  - `slug` string — url-safe slug for the goal target, auto-generated from goal slug and label if not provided
  - `startValue` union — starting point value for this target, as-of the date of the goal
    - string
    - number
    - boolean
  - `targetValues` GoalTargetValue[] — potential target values we're working to achieve
    - `targetValueTypeId` string — the type of the target value (for example, 'Stretch' vs 'Minimum'), extracted from the goal type's targetValues
    - `value` union, required — target value to achieve (should be a numeric value, either number, money, or percentage)
      - string
      - number
      - boolean
  - `direction` 'MINIMIZE' | 'MAXIMIZE' | 'TARGET' — direction of the target -- whether we want to minimize or maximize the value
  - `type` 'MILESTONE' | 'MONEY' | 'PERCENT' | 'INTEGER' | 'DECIMAL', required — type of the target value
  - `valueExpr` string — Carrot expression used to compute the current value versus target -- if not provided, GoalProgress will be used to track progress
  - `startDate` string, date, required — start date for this goal target
  - `endDate` string, date, required — end date for this goal target
  - `createId` string — 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 — 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.dev/charthop/apis/charthop-api.md) · [All operations](https://skmtc.dev/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/charthop/apis/charthop-api/revisions/8573012012f9?raw)