Nothing Found

Get Task

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.

SecurityAuthorization_Token
Request
path Parameters
task_id
required
string
query Parameters
custom_task_ids
boolean

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

team_id
number <double>

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.

Responses
200
get/v2/task/{task_id}
Request samples 
Response samples 
application/json
{}
ClickUp Logo
Login