Sign in

v1

latestOpenAPI 3.1.02026-08-066984441.1 MB
taskLists

Returns all task lists of the project with the specified id.

The permission check in this function is dynamically based on the entity name. In the cases where the user tries to get the project task lists, the user needs read permissions on the project-planning-data feature.

<Check title="Required Permissions" icon="key">Any authenticated user.</Check>

get/projects/{projectId}/tasklists

Path parameters

projectIdstring uuid required

The id of the project.

Query parameters

showArchivedboolean

The show Archived.

pageinteger

Page number for pagination

pageSizeinteger

Number of items per page

orderbystring

The properties to order by

filterbystring

The filter expression to filter by

Headers

Authorizationstring required

Bearer authentication

Response

OK

idstring uuid

The id of the task list.

createdOnstring date-time

The date this task list was created.

createdBystring uuid

The id of the user who created this task list.

updatedOnstring date-time

The date this task list was last modified.

updatedBystring uuid

The id of the user who last modified this task list.

namestring nullable

The name of the list.

ordernumber double nullable

The order of the list.

plannedDurationinteger nullable

The planned duration for this task list, in seconds.

totalPlannedDurationinteger nullable

The total planned duration for this task list, including all primary tasks (parent tasks which have this tacklist as PrimaryTaskListId), in seconds. Calculated: sum PlannedDuration of primary tasks in list Archived task lists are not included in the calculation.

totalPlannedDurationWithHierarchyinteger nullable

The total planned duration for this task list, including all primary tasks (parent tasks which have this task list as PrimaryTaskListId), in seconds. Calculated: max(PlannedDuration, sum TotalPlannedDurationWithHierarchy of primary tasks in list) Archived task lists are not included in the calculation.

isArchivedboolean

Whether the task list has been archived.

isHiddenForConnectUsersboolean

True if the task in this list will be not visible for external workspace users. False otherwise.

trackedDurationinteger

The total duration of time trackings for tasks in this task list, in seconds. Includes both billable and non-billable time trackings. Backend-calculated property. When hierarchy feature flag is enabled: only tasks with PrimaryTaskListId == this list. When hierarchy feature flag is disabled: all tasks associated with this list.