For more details on how to work with custom fields please refer to Working with custom fields guide.
The Task object represents a task within the project management system.
You can find out more about tasks in our Help documentation: Tasks and task lists
Task can be one of two types:
Following diagram shows tasks in our data hierarchy:
For Task dependencies please refer to TaskDependency endpoint documentation
Return tasks created on or after this date.
The person assigned to this task.
Filter by assigned person (also matches open to-do assignees).
Filter by assigned person (also matches open to-do assignees).
Files attached to this task.
Files attached to this task.
Return tasks created on or before this date.
Total billable hours tracked on this task (time + correction for billable services, zero for non-billable).
Number of tasks this task is blocking from starting.
Filter by folder (board) ID.
Filter by folder name (text search).
Sort position of this task within its board (folder).
The open/closed status of the task list (board) this task belongs to.
1
2
Filter tasks to those bookable after this date.
Filter tasks to those bookable before this date.
Number of scheduled bookings referencing this task.
Whether the task is closed (derived from closed_at).
Return tasks closed on or after this date.
Timestamp when the task was closed, or null if still open.
Return tasks closed on or before this date.
Filter by client company (via the task's project).
Filter by client company (via the task's project).
Timestamp when the task was created.
How the task was created (e.g. manually, via automation, via email).
1
2
3
4
The person who created this task.
ID of the person who created this task.
The name of the person who created this task.
Files uploaded to file-type custom fields on this task.
People referenced in person-type custom fields on this task.
Custom field values set on this task.
Filter tasks overlapping a date range (for timeline/Gantt views).
Timestamp if the task was soft-deleted, null otherwise.
Filter by dependency type: blocking, waiting on, or linked.
1
2
3
Date by which the task should be completed.
Return tasks due on or after this date.
Return tasks due on or before this date.
Return tasks due on this exact date.
Return tasks due on this exact date.
Time of day for the due date deadline (HH:MM format).
Unique key for creating comments on this task via email.
Filter by folder ID (alias for board_id).
Filter by folder name (alias for board_name).
Sort position of this task within its folder.
Filter by whether the folder is active or archived (alias for board_status).
1
2
Full-text search across task fields.
Fuzzy date matching across task date fields.
Fuzzy match by people related to the task.
The unique identifier of this task.
Originally forecasted time needed to complete the task, in minutes.
Quick jump search by task name or number.
Timestamp of the most recent activity on this task.
Return tasks with last activity after this date.
Timestamp of the most recent activity on this task.
Return tasks with last activity before this date.
The last person who made changes to this task.
ID of the person who last performed an activity on this task.
The name of the person who last performed an activity on this task.
Number of tasks linked to this one (informational, no blocking).
Short numeric identifier (alias for task_number).
Number of unclosed subtasks.
Number of uncompleted to-do items.
The organization this task belongs to.
Filter by whether the task is overdue (past due date).
1
2
The parent task if this is a subtask.
Filter by parent task (to find subtasks of a specific task).
Filter by parent/subtask distinction.
Sort position of this task within its task list.
Whether this task is visible only to project members (not shared via public links).
The project this task belongs to.
ID of the project (workspace) this task belongs to.
Filter by the project's responsible person.
The name of the project this task belongs to.
Filter by project type: internal (overhead) or client (billable).
1
2
Filter by task privacy (deprecated — use private filter instead).
Quick search matching task title and number.
Extended search matching title, number, and description.
Current projection of time still needed, decreases as time is tracked or can be adjusted manually.
The recurring schedule configuration if this task repeats.
Whether this task is part of a repeating schedule.
Specific date for date-based recurring tasks.
How frequently the task repeats (e.g. daily, weekly, monthly).
Day of the month for monthly recurring tasks.
Day of the week for weekly recurring tasks.
ID of the original task that spawned this recurring instance.
ID of the repeat schedule if this task recurs on a regular interval.
1
2
3
4
5
The budget service linked to this task for time tracking and billing.
ID of the service (billing point) this task is linked to.
If true, skips reordering of other tasks when placing this one.
Date when work on the task is planned to begin.
Return tasks starting on or after this date.
Return tasks starting on or before this date.
Filter by open (1) or closed (2) status.
1
2
ID of a person who is subscribed to notifications for this task.
Array of IDs of people subscribed to notifications for this task.
Whether this task is a subtask of another task.
Total number of subtasks under this task.
Sort position among sibling subtasks under the parent task.
Tags applied to this task.
Tags applied to this task.
Total number of dependency relationships on this task.
The task list this task belongs to within a folder.
ID of the task list (milestone) this task belongs to.
Filter by task list name (text search).
Sort position of this task within its task list.
The open/closed status of the task list this task belongs to.
1
2
Unique number identifying a task within the organization.
Filter by parent/subtask distinction.
1
2
Return only template tasks.
ID of the template this task was created from.
The template this task was created from, if applicable.
Descriptive name of the task.
IDs of people assigned to open to-do items on this task.
Total number of to-do checklist items on this task.
Filter tasks to those trackable by the specified person, based on restricted tracking settings.
Task type: regular task, subtask, or milestone.
1
3
Timestamp when the task was last modified.
Number of tasks this task is waiting on before it can proceed.
Total time tracked on this task across all time entries, in minutes.
ID of the workflow this task's status belongs to.
Current workflow status of this task (e.g. 'To Do', 'In Progress', 'Done').
Filter by status category: not started (1), started (2), or closed (3).
1
2
3
ID of the workflow status currently assigned to this task.
Current workflow status of this task (e.g. 'To Do', 'In Progress', 'Done').
Sort position of the workflow status within its workflow.