---
title: "Update Task"
method: PATCH
path: "/v1/tasks/{id}"
---

# Update Task

`PATCH /v1/tasks/{id}`

This API endpoint updates a task.

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string — The name of the task.
  - `description` string — The description of the task.
  - `status` string — The status of the task.
  - `internalUserId` string — The uuid of the internal user assigned to this task.
  - `clientId` string — The uuid of the client user assigned to this task.
  - `companyId` string — The uuid of the company assigned to this task. If assigning to a client user field should be required as well.
  - `dueDate` string — The date the task is due, in RFC3339 format.
  - `isArchived` boolean — Whether to archive the task or not.
  - `viewers` object — The ID of the company or client that you would like to grant viewing access to the task. Viewers can only be added to tasks where the assignee is an internal user. Currently, only one entity (either a client or a company) can be added as a viewer per task.
    - `clientId` string — If the task viewer is a client, you must add both the clientId and their companyId.
    - `companyId` string — If the task viewer is a company, you must only add the companyId (leave clientId empty).

## Response `200`

200

- object
  - `archivedBy` string
  - `archivedDate` string
  - `clientId` string
  - `companyId` string
  - `completedBy` string
  - `completedByUserType` string
  - `completedDate` string
  - `createdBy` string
  - `createdDate` string
  - `creatorType` string
  - `deletedBy` string
  - `deletedDate` string
  - `description` string
  - `dueDate` string
  - `id` string
  - `isArchived` boolean
  - `isDeleted` boolean
  - `label` string
  - `name` string
  - `object` string
  - `parentTaskId` string
  - `source` string
  - `status` string
  - `templateId` string
  - `viewers` object[]
    - `clientId` string
    - `companyId` string
  - `attachments` object[]

## Other responses

- `400` — 400

---

[API](https://skmtc.net/assembly/apis/core-resources.md) · [All operations](https://skmtc.net/assembly/apis/core-resources/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/assembly/core-resources/versions/28a9e7d13a8c/schema)