Skip to main content
GET
List a project's tasks
Lists the tasks of a project the caller may read (projects:read at the project’s home), newest first. projectId is required; status filters to one task status. A missing, malformed or unreadable project answers 404. Only a project’s ordinary tasks are here. A factory task is read and changed through the factory task operations, and a task with no project is never returned. Assigning a task is done by a person in Console. Because factory tasks are left out after paging, a page can be short or empty while meta.hasMore is true; follow meta.nextCursor. Each ProjectTask carries its id, project, title, status, priority, kind, tags, timestamps and assignee: {type: "agent", workerId}, {type: "person"} (the person is never identified) or null. The creator, milestone, parent and dependency links, GitHub and external links, factory fields and work-pool fields are never returned.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Path Parameters

projectId
string
required
Minimum string length: 1

Query Parameters

status
enum<string>
Available options:
ICEBOX,
BACKLOG,
READY,
ASSIGNED,
IN_PROGRESS,
BLOCKED,
IN_REVIEW,
COMPLETE,
CANCELLED
limit
integer
default:50
Required range: 1 <= x <= 100
cursor
string
Minimum string length: 1

Response

Success

data
object[]
required
meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.