Skip to main content
GET
Get a roadmap's critical path
Returns { tasks }: the tasks of a roadmap’s milestones (optionally one workstreamId or projectId), cancelled tasks skipped, sorted least slack first. Slack is the milestone’s target date minus now, four weeks when it has none. The answer is the limit tasks with the least slack; limit defaults to 200, at most 500 (a larger value is 400 too_big), and tasks cut by limit alone do not make the answer partial. A roadmapId that is missing or names no roadmap is 404 resource_missing. 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 (a project, no factory) 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 a read bound (200 milestones, 300 tasks or 100 active tasks per milestone) was reached, more than 4,000 tasks would have to be read in one request, more than 50 distinct projects had to be decided, or a project’s read could not be decided.

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

roadmapId
string
required

Query Parameters

workstreamId
string
projectId
string
limit
integer
default:200
Required range: 1 <= x <= 500

Response

Get a roadmap's critical path

data
object
required
meta
object
required