Skip to content

Get dependency graph for a task list

GET
/api/v3/organizations/{organisation}/ai/tasks/{taskListId}/dependency-graph

Returns the full dependency graph for all tasks in a task list. * * Use Cases: * - Visualize task dependencies in a UI (DAG diagram) * - Analyze workflow structure and critical paths * - Find starting tasks (roots) and terminal tasks (leaves) * - Plan parallel execution by identifying independent task groups * * Response Structure: * - taskCount: Total number of tasks in the list * - roots: Task IDs with no dependencies (starting points) * - leaves: Task IDs with no dependents (terminal tasks) * - graph: Adjacency list with each task’s dependencies and dependents

Authorizations

Parameters

Path Parameters

organisation
required
string

The organisation ID

taskListId
required
string

The task list ID to get the dependency graph for

Example
world-1

Responses

200

Dependency graph retrieved successfully

object
taskListId
string
world-1
taskCount
integer
4
roots

Task IDs with no dependencies

Array<string>
leaves

Task IDs with no dependents

Array<string>
graph

Adjacency list with task summaries, dependsOn, and dependents arrays

object

500

Failed to get dependency graph