Get Task

get

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

View information about a task. You can only view task information of tasks you can access.

Tasks with attachments will return an "attachments" response.

Docs attached to a task are not returned.

The custom_fields array only includes Custom Fields applicable to the task's custom_item_id. Use Get Custom Fields and each field's applied_objects to discover which fields apply to which task types.

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.

include_subtasks

boolean

Include subtasks, default false

include_markdown_description

boolean

To return task descriptions in Markdown format, use ?include_markdown_description=true.

custom_fields

array of strings

Include tasks with specific values in one or more Custom Fields. Custom Relationships are included.

For example: ?custom_fields=[{"field_id":"abcdefghi12345678","operator":"=","value":"1234"},{"field_id":"jklmnop123456","operator":"<","value":"5"}]

Only set Custom Field values display in the value property of the custom_fields parameter. If you want to include tasks with specific values in only one Custom Field, use custom_field instead.

Learn more about filtering using Custom Fields.

custom_fields

Response

200