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.

Path Params

task_id

string

required

Query Params

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

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.clickup.com/api/v2/task/ \
3
     --header 'accept: application/json'

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

application/json

200