API reference / Tasks and projects
Get the tree of a task
Who started whom: the top task of a task, and each task under it that a teammate has, with the work of that teammate. A teammate hands a part of its task to another teammate, so the tree goes deeper than the sub-tasks of the board.
/api/v1/tasks/{key}/treeOther ways to call it
troopy tasks treetroopy_get_task_treePath parameters
key*stringA task's key (VIR-12), its number (12) or its id
At least 1 characters · At most 40 characters
Response
200 · application/jsondata*object2 properties
top*stringThe key of the top task: the root of the tree
nodes*array<object>The top task first, then each task under it that a teammate has, in the order they were made
14 properties
key*stringIts key, like VIR-12
title*stringstatus*enum<string>backlogtodoin_progressneeds_youin_reviewdonecanceled
from*string | nullThe key of the task that started it: the task that handed it on, else its parent. null for the top task
assignee*object | null3 properties
type*enum<string>agentperson
id*stringname*stringstate*enum<string>Its status, or working, queued, or waiting (for the work that it handed on)
backlogtodoin_progressneeds_youin_reviewdonecanceledworkingqueuedwaiting
doing*string | nullWhat its teammate says it does now, in its own few words
runId*string | nullThe run on it now, else its last run
model*string | nullThe model of its last round, like Sonnet 5.5. null before its first round
families*array<enum<string>>The families of the tools that its runs called, in the order of their first call
browserbrainhelptasksskillsinboxbrain_editsemailhiringroutinescanvasesresearchbrandwebpicturesleadsand 13 more
steps*integerThe tool calls of its runs
ms*integerThe time that its runs worked, in milliseconds, without the run on it now
since*string | nullWhen the run on it now started: its time goes on from there
usd*number | nullWhat its rounds cost in USD, on AI plans that bill each use. null on other plans