Update Task

put

https://api.clickup.com/api/v2/task/{task_id}

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

task_id

string

required

Query Params

custom_task_ids

boolean

If you want to reference a task by its custom task id, this value must be true.

team_id

number

When the custom_task_ids parameter is set to true, the Workspace ID must be provided using the team_id parameter.

For example: custom_task_ids=true&team_id=123.

Body Params

Note: To update Custom Fields on a task, you must use the Set Custom Field endpoint.

custom_item_id

number | null

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 responses.

To get a list of available custom task type IDs for your Workspace, use the Get Custom Task Types endpoint.

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

group_assignees

object

watchers

object

archived

boolean

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200