clickup · Schema
ClickUp Task
A task object representing a unit of work in ClickUp. Tasks are the core entity in ClickUp and contain information about assignees, status, priority, due dates, custom fields, time tracking, and more.
Properties
| Name | Type | Description |
|---|---|---|
| id | string | The unique identifier of the task. |
| custom_id | stringnull | The custom task ID if enabled for the Workspace. |
| name | string | The name of the task. |
| text_content | stringnull | The plain text content of the task description. |
| description | stringnull | The task description in rich text format. |
| markdown_description | stringnull | The task description in Markdown format. |
| status | object | |
| orderindex | string | The order index of the task within its list. |
| date_created | string | Unix timestamp in milliseconds when the task was created. |
| date_updated | string | Unix timestamp in milliseconds when the task was last updated. |
| date_closed | stringnull | Unix timestamp in milliseconds when the task was closed. |
| date_done | stringnull | Unix timestamp in milliseconds when the task was marked done. |
| archived | boolean | Whether the task is archived. |
| creator | object | |
| assignees | array | The users assigned to the task. |
| watchers | array | The users watching the task. |
| checklists | array | Checklists attached to the task. |
| tags | array | Tags applied to the task. |
| parent | stringnull | The ID of the parent task if this is a subtask. |
| priority | object | |
| due_date | stringnull | Unix timestamp in milliseconds for the due date. |
| start_date | stringnull | Unix timestamp in milliseconds for the start date. |
| points | numbernull | Sprint points assigned to the task. |
| time_estimate | integernull | Time estimate in milliseconds. |
| time_spent | integer | Total time tracked on the task in milliseconds. |
| custom_fields | array | Custom field values set on the task. |
| dependencies | array | Task dependencies. |
| linked_tasks | array | Tasks linked to this task. |
| team_id | string | The Workspace ID the task belongs to. |
| url | string | The URL to the task in the ClickUp web application. |
| list | object | |
| project | object | |
| folder | object | |
| space | object | The space the task belongs to. |