---
title: "Update Task"
method: PUT
path: "/v2/task/{task_id}"
tags: ["Tasks"]
---

# Update Task

`PUT /v2/task/{task_id}`

Update a task by including one or more fields in the request body.

## Path parameters

- `task_id` string, required

## Query parameters

- `custom_task_ids` boolean
- `team_id` number

## Request body

- object
  - `custom_item_id` number, nullable — The custom task type ID for this task. A value of `0` (default) sets the task type to type "Task".\ \ Changing the task type affects which Custom Fields appear on subsequent [Get Task](https://developer.clickup.com/reference/gettask) responses.\ \ To get a list of available custom task type IDs for your Workspace, use the [Get Custom Task Types endpoint](https://developer.clickup.com/reference/getcustomitems).
  - `name` string
  - `description` string — To clear the task description, include `Description` with `" "`.
  - `markdown_content` string — Markdown formatted description for the task. If both `markdown_content` and `description` are provided, `markdown_content` will be used instead of `description`.
  - `status` string
  - `priority` integer
  - `due_date` integer
  - `due_date_time` boolean
  - `parent` string — You can move a subtask to another parent task by including `"parent"` with a valid `task id`.\ \ You cannot convert a subtask to a task by setting `"parent"` to `null`.
  - `time_estimate` integer
  - `start_date` integer
  - `start_date_time` boolean
  - `points` number — Update the task's Sprint Points.
  - `assignees` object
    - `add` integer[], required
    - `rem` integer[], required
  - `group_assignees` object
    - `add` string[]
    - `rem` string[]
  - `watchers` object
    - `add` integer[], required
    - `rem` integer[], required
  - `archived` boolean

## Response `200`

- object
  - `id` string
  - `custom_id` string, nullable
  - `custom_item_id` number, nullable — The custom task type ID for this task. A value of `0` represents task type "Task".\ \ To get a list of available custom task type IDs for your Workspace, use the [Get Custom Task Types endpoint](https://developer.clickup.com/reference/getcustomitems).
  - `name` string
  - `text_content` string, nullable
  - `description` string, nullable
  - `markdown_description` string
  - `status` Status — unresolved $ref
  - `archived` boolean
  - `orderindex` string
  - `date_created` string
  - `date_updated` string
  - `date_closed` string, nullable
  - `date_done` string, nullable
  - `creator` Creator — unresolved $ref
  - `assignees` string[]
  - `group_assignees` string[]
  - `watchers` string[]
  - `checklists` string[]
  - `tags` string[]
  - `parent` string, nullable
  - `top_level_parent` string, nullable
  - `priority` Priority — unresolved $ref
  - `due_date` string, nullable
  - `start_date` string, nullable
  - `points` number, nullable
  - `time_estimate` string, nullable
  - `time_spent` number
  - `custom_fields` Items[] — unresolved $ref
  - `dependencies` string[]
  - `linked_tasks` string[]
  - `locations` Items[] — Array of Lists where the task has been added. — unresolved $ref
  - `team_id` string
  - `url` string
  - `sharing` object
    - `public` boolean
    - `public_share_expires_on` string, nullable
    - `public_fields` string[]
    - `token` string, nullable
    - `seo_optimized` boolean
  - `permission_level` string
  - `list` List — unresolved $ref
  - `project` Folder — unresolved $ref
  - `folder` Folder — unresolved $ref
  - `space` Space — unresolved $ref
  - `subtasks` object[]
  - `attachments` object[]

---

[API](https://skmtc.dev/clickup/apis/clickup-api-v2-reference.md) · [All operations](https://skmtc.dev/clickup/apis/clickup-api-v2-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clickup/clickup-api-v2-reference/revisions/72216f55b952/schema)