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.

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>

Only used when the custom_task_ids parameter is set to true.

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"}]

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