Skip to main content
GET
List blocked tasks
Returns { tasks }: BLOCKED tasks that name a blocker, newest first, optionally of one projectId. limit defaults to 100, at most 200 (a larger value is 400 too_big). The credential needs the objectives:read and projects:read scopes and objectives:read at the deployment root. A task is included only when it is an ordinary project task whose project you may read (projects:read at the project’s home); other tasks are omitted without a count, and no assignee is ever named. meta.partial is true when more than 300 blocked tasks exist, more than 50 distinct projects had to be decided, or a project’s read could not be decided. A person’s own blockers and the tasks they could help with stay Console views.

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.

Query Parameters

projectId
string
limit
integer
default:100

Items per page, 1 to 200 (default 100); a larger value is a 400 too_big. A page may hold fewer items than limit while meta.hasMore is true; continue with meta.nextCursor.

Required range: 1 <= x <= 200
cursor
string

The previous page's meta.nextCursor; any other value is 400.

Minimum string length: 1

Response

List blocked tasks

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.