Nothing Found

Get Task

View information about a task.
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 it's 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

Instead of description you can pass markdown_description with valid markdown syntax to add formatting to the task description.

Responses
200
get/task/{task_id}
Request samples 
Response samples 
application/json
{
  • "id": "string",
  • "custom_id": "string",
  • "custom_item_id": 0,
  • "name": "string",
  • "text_content": "string",
  • "description": "string",
  • "status": {
    },
  • "orderindex": "string",
  • "date_created": "string",
  • "date_updated": "string",
  • "date_closed": "string",
  • "creator": {},
  • "assignees": [
    ],
  • "checklists": [
    ],
  • "tags": [
    ],
  • "parent": "string",
  • "priority": "string",
  • "due_date": "string",
  • "start_date": "string",
  • "time_estimate": "string",
  • "time_spent": "string",
  • "custom_fields": [
    ],
  • "list": {
    },
  • "folder": {
    },
  • "space": {
    },
  • "url": "string",
  • "markdown_description": "string"
}
ClickUp Logo