---
title: "Update an existing task"
method: PATCH
path: "/v1/org/{orgId}/task/{taskId}"
tags: ["task"]
---

# Update an existing task

`PATCH /v1/org/{orgId}/task/{taskId}`

## Path parameters

- `orgId` string, required
- `taskId` string, required

## Request body

- UpdateTask
  - `status` 'PENDING' | 'DONE' | 'EXPIRED' | 'SKIPPED' — status of this task
  - `label` string — The user-visible label for the task; if not set, will automatically default based on the task type
  - `message` string — The message attached to this task
  - `shareAccess` ShareAccess[] — users who are specifically granted permission to view or edit this task
    - `access` 'NONE' | 'LIMITED_READ' | 'LIMITED_WRITE' | 'STANDARD_READ' | 'STANDARD_WRITE' | 'COMPENSATION_READ' | 'FULL_READ' | 'COMP_PLANNING_PARTICIPANT' | 'COMPENSATION_WRITE' | 'WRITE' | 'COMPENSATION_OWNER' | 'OWNER', required — access permission level
    - `userId` string — user id
    - `groupId` string — group id
    - `fields` string — fields
  - `taskConfigId` string — id of the TaskConfig
  - `slug` string — slug used to reference tasks in events
  - `dueAt` string — due date for the task
  - `pastDueAction` 'NONE' | 'SET_EXPIRED' — what action to take when the task is past its due date
  - `isSkippable` boolean — check for if the task can be skipped

## Response `204`

task updated

## 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/revisions/26da34ae934f/schema)