Skip to content
LogoLogo

List Project Tasks

List Project Tasks

GET/api/v1/projects/{project_id}/tasks

Returns one page ordered by the Task's immutable project-local number by default. Column orders require exactly one status_id, exclude archived Tasks, and return a snapshot-consistent column total and advisory movement permission instead of global history counts. Cursors bind the Project, Status, order and filters. Rank pagination is a live traversal; concurrent moves can require refreshing earlier pages.

Path Parameters

project_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001

Query Parameters

cursor
string·min 1·max 2048

Opaque continuation cursor returned by the preceding page.

limit
integer·min 1·max 100·default 50

Maximum number of resources to return.

state
string·default all

Filter by the lifecycle umbrella derived from current resolution facts.

Values
activeresolvedall
status_id
string <uuid>[]·max 100
assignee_actor_id
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001
resolution
string
Values
completedcancelled
include_archived
boolean·default false
order
string·default number

Column rank order or newest resolution first; number retains history semantics.

Values
numberrankrank_descresolved_desc
resolved_since
string <date-time>

Inclusive recent-resolution cutoff for column orders; does not restrict column.total.

anchor_task_id
string <uuid>

Start strictly after this current Task in the chosen rank direction. Must belong to this Project and Status. Cannot accompany cursor or resolved_desc. Other history filters are not accepted with column orders.

Example0198ac5e-f9b7-7000-8000-000000000001
milestone_id
string <uuid>[]·max 100

Match any selected milestone before pagination. Supported with number order only; an unknown or other-Project ID matches no Tasks.

Responses