Returns all tasks the user is allowed to see.

GET

Returns all tasks the user is allowed to see. This contains project tasks if the user has “project-planning” permissions, all assigned tasks and also private tasks created by the user and assigned to other users.

Required Permissions: Any authenticated user.

Path parameters

userIdstringRequired

The id of the user. Not required on the /me endpoint.

Query parameters

pageintegerOptional

Page number for pagination

pageSizeintegerOptional

Number of items per page

orderbystringOptional

The properties to order by

filterbystringOptional

The filter expression to filter by

Response

OK

namestring>=1 character

The name of the task. Max allowed length: 25000 characters.

descriptionstringOptional

The description of the task. Max allowed length: 25000 characters.

isPriobooleanOptionalDefaults to false

Whether this task is marked as priority.

startOndatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The expected start date and time of the task.

dueOndatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The expected due date and time of the task.

laneOrderintegerOptional

The lane order defines the vertical position in the task board.

plannedDurationintegerOptional

The expected planned workload of the task, in seconds.

remainingDurationintegerOptional

The expected remaining duration from the original planned effort of the task, in seconds. Null if the user has no permissions to see time tracking information.

idstringOptional

The Id of the task.

isExternalbooleanOptionalDefaults to false

True if the model is coming from an external workspace (awork Connect). False otherwise.

isHiddenForConnectUsersbooleanOptionalDefaults to false

True if the task is hidden for external workspace users. False otherwise.

baseType"private" or "projecttask"Optional
Allowed values: privateprojecttask

The base type of the task. Can be ‘private’ for a private task or ‘projecttask’ for a project task.

taskStatusIdstringOptional

The id of the status for this task.

taskStatusobjectOptional
typeOfWorkIdstringOptional

The id of the type of work of this task.

typeOfWorkobjectOptional
assigneeslist of objectsOptional

The list assigned users of this task, or empty if not user was assigned.

projectIdstringOptional

The id of the project this task is assigned to. Only set if this is a project task. In this case, it is equal to the EntityId.

projectobjectOptional
correlationIdstringOptional

The correlation id between parent and subtasks, meaning it’s either the ParentId or its own Id.

parentIdstringOptional

The id of the parent task this of this subtask. Only set if this is a subtask.

parentTaskobjectOptional
isSubtaskbooleanOptionalDefaults to false

True if the task is a subtask.

numberOfSubtasksintegerOptional

The number of subtasks of this task. Null if it’s not a parent task.

hasAttachmentbooleanOptionalDefaults to false

Whether this task has an attachment.

listslist of objectsOptional

The lists to which the task is assigned to.

userIdstringOptional

The id of the user of the private task.

tagslist of objectsOptional

The list of tags.

createdOndatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The date this task was created.

createdBystringOptional

The id of the user who created this task.

updatedOndatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The date this task was last modified.

updatedBystringOptional

The id of the user who last modified this task.

closedOndatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The date the task was set to closed.

closedBystringOptional

The user who closed the task.

orderdoubleOptional

The order of the task in a task status column.

subtaskOrderdoubleOptional

The order of the subtask relative to its parent task.

createdFromTaskIdstringOptional

When the task was created by a recurrency rule, the id is the link to the template of which the task was created.

isRecurringbooleanOptionalDefaults to false

If the task is a recurrency template (used to create new tasks by a recurrency rule), the flag is true.

customFieldslist of objectsOptional

Custom fields of the task.

trackedDurationintegerOptional

The summed up duration of all time trackings for this task.

totalTrackedDurationintegerOptional

The summed up duration of all time trackings for this task, including subtasks.

totalPlannedDurationintegerOptional

The total planned workload of the task, in seconds, including subtasks.

totalRemainingDurationintegerOptional

The total remaining duration from the original planned effort of the task, in seconds, including subtasks.

resourceVersionlongOptionalDefaults to 0

The version of the entity, updated on every modification, to the ticks in UTC. Not identical to UpdatedOn.

checklistItemsDoneCountintegerOptional

The number of checklist items marked as done.

checklistItemsCountintegerOptional

The total number of checklist items.

taskSchedulesCountintegerOptional

The number of task schedules for this task.

isCompletelyScheduledbooleanOptionalDefaults to false

Whether this task is completed scheduled.

commentCountintegerOptional

The number of comments on this task.

entityIdstringOptionalDeprecated

The id of the entity this task is assigned to. This is the id of the project if this is a project task, or the id of a user if this is a private task. See ‘BaseType’ for supported types.