---
title: "Update List"
method: PUT
path: "/v2/list/{list_id}"
tags: ["Lists"]
---

# Update List

`PUT /v2/list/{list_id}`

Rename a List, update the List Info description, set a due date/time, set the List's priority, set an assignee, set or remove the List color.

## Path parameters

- `list_id` string, required

## Request body

- object
  - `name` string, required
  - `content` string
  - `markdown_content` string — Use `markdown_content` instead of `content` to format your List description.
  - `due_date` integer
  - `due_date_time` boolean
  - `priority` integer
  - `assignee` string
  - `status` string — **Status** refers to the List color rather than the task Statuses available in the List.
  - `unset_status` boolean — By default, this is `false.` To remove the List color use `unset_status: true`.

## Response `200`

- object
  - `id` string
  - `name` string
  - `orderindex` integer
  - `content` string
  - `status` Status — unresolved $ref
  - `priority` Priority — unresolved $ref
  - `assignee` string, nullable
  - `task_count` string, nullable
  - `due_date` string
  - `due_date_time` boolean
  - `start_date` string, nullable
  - `start_date_time` string, nullable
  - `folder` Folder — unresolved $ref
  - `space` Space — unresolved $ref
  - `statuses` Status[] — unresolved $ref
  - `inbound_address` string

---

[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)