API referenceAgents and workflowsTeams
Teams
16 operations.
List agent teams
GET /api/v1/teams
Spawn an agent team (role-assigned agents that collaborate on a task)
POST /api/v1/teams
Get an agent team (members + live online state)
GET /api/v1/teams/{id}
Update an agent team's settings (name, model, budgets)
PUT /api/v1/teams/{id}
Delete an agent team and its conversation log
DELETE /api/v1/teams/{id}
Archive an agent team (deletes member VMs for good; keeps the conversation log)
POST /api/v1/teams/{id}/archive
Send a chat message to the team's lead agent
POST /api/v1/teams/{id}/chat
Download a file an agent shared from the team's storage
GET /api/v1/teams/{id}/files
Stop the running task only (the composer stop button) — members and conversation stay alive
POST /api/v1/teams/{id}/interrupt
Interactive terminal into a team member's sandbox (WebSocket)
GET /api/v1/teams/{id}/members/{memberId}/terminal
Read the team conversation log (cursor-paged; pass next as ?after=)
GET /api/v1/teams/{id}/messages
Pause an agent team (snapshots + frees member VMs; the next chat message wakes it)
POST /api/v1/teams/{id}/pause
Approve a planning team's proposed roster (optionally edited) and launch it
POST /api/v1/teams/{id}/plan/approve
Re-deliver the lead's last task exactly as originally sent (after a failure)
POST /api/v1/teams/{id}/retry
Stop an agent team (tears down member runs; keeps the conversation log)
POST /api/v1/teams/{id}/stop
Team live-output stream (SSE)
GET /api/v1/teams/{id}/stream