API reference / Troop
List teammates
The workspace's troop, its lead first, with what each is doing now. Every workspace starts with a Chief of Staff (handle chief).
/api/v1/agentsOther ways to call it
troopy agents listtroopy_list_agentsResponse
200 · application/jsondata*array<object>15 properties
handle*stringname*stringrole*stringThe role it was hired into, like writer, or custom
title*stringThe job, like Content writer
tagline*stringWhat it does, in a few words, like Writes emails, articles and web copy in your voice
area*enum<string>The area it works in: engineering, marketing or operations; lead for the troop's lead
leadengineeringmarketingoperations
lead*booleanThe troop's lead, whom a conversation goes to unless it names another teammate
avatar*objectIts face: a bot-avatars body type, colour (#RRGGBB), face and shading, a robot head, or an object with two eyes
6 properties
shape*enum<string>cloverflowertrianglesquareblobghostcircledropstardroidmechalienhexagoncatcloudpilland 2 more
color*stringface*enum<string>eyesmouth
shadingenum<string>How its body is lit; fabric when unset
fabricplasticcrispsmoothflat
robotobjectA TV-headed robot (robot-heads) in place of the bot. shape, color, face and shading stay for the bot
5 properties
shape*enum<string>rectanglesquarecirclehexagon
shell*stringThe colour of its shell
trim*stringThe colour of its ears and of the collar of its antenna
screen*stringThe colour of the lights on its screen
antenna*booleanobjectobjectAn object with two eyes in place of the bot. shape, color, face and shading stay for the bot
2 properties
shape*enum<string>circlesquaretrianglepilldrophexagonpentagoncloudbeancloverflowersparkleburstapplechatbulband 13 more
color*stringThe colour of the object
status*enum<string>working: a run is going. paused: it won't start runs until resumed
idleworkingpaused
needsYou*booleanIt waits on a person: a task of its own waits in Needs you (a question, or a call to approve), or a call of its own waits for a yes (GET /approvals)
lastActiveAt*string | nullWhen it last finished a run
doing*string | nullWhile it works: what it is doing, in its own few words, like "Checking Acme's payment terms"; null before its first step says
plan*string | nullThe id of the AI plan it starts on; null follows the organization's default
model*string | nullThe model it runs on, from its plan's list (GET /ai-plans/{plan}/models); null uses the plan's model
effort*enum<string> | nullHow hard its model thinks, one that its model takes; null uses the plan's effort on the plan's model, else the model's default
lowmediumhighxhighmax