teams.*
Team and multi-agent orchestration RPC methods
Team methods manage multi-agent teams — a leader plus members that collaborate through a durable group-chat thread and a shared task board. On a team's first message the leader plans first ("Team Strata" strategic coordination); the plan is welded into every member's prompt, and members work under assigned Coord Tasks (Pending -> InProgress -> WaitingReview -> Completed).
Related list endpoint:
agents.teamsreturns the team list augmented with a smallmembers_previewandlast_messageper team (used to render the sidebar's "Group Chats" history). For the live group-chat session primitive, seegroup_chat.*.
CRUD
teams.create
Create a team from a leader, a set of members, and an optional auto-naming flag. A blank-named team gets LLM auto-naming on its first message when auto_name is set.
Request:
{
"jsonrpc": "2.0",
"id": 1,
"method": "teams.create",
"params": {
"leader": "main",
"members": ["reviewer", "tester", "documenter"],
"auto_name": true
}
}Response:
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"team": {
"id": "team-1",
"name": "",
"leader": "main",
"members": ["reviewer", "tester", "documenter"]
}
}
}Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
leader | string | Yes | Agent id that plans and reviews member work |
members | string[] | Yes | Agent ids working under assigned Coord Tasks |
auto_name | boolean | No | Let the LLM name a blank team on first message |
teams.get
Get a single team's details (leader, members, name).
teams.list
List all configured teams.
teams.rename
Rename a team.
teams.disband
Disband a team — tears down its working state while preserving history.
teams.delete
Delete a team configuration.
Chat
The team work-thread is a durable, per-team group-chat thread. Its history powers the attribution-bubble replay in the group-chat window.
teams.chat.send
Send a message into the team's group-chat thread. Routed to the leader on first message for planning, and to members per their Coord Tasks.
Request:
{
"jsonrpc": "2.0",
"id": 2,
"method": "teams.chat.send",
"params": {
"team_id": "team-1",
"text": "Review this pull request for security issues",
"mention": "@all"
}
}teams.chat.thread
Fetch the team's durable group-chat thread metadata.
teams.chat.history
Replay the message history for a team's thread (drives attribution bubbles).
Request:
{
"jsonrpc": "2.0",
"id": 3,
"method": "teams.chat.history",
"params": {
"team_id": "team-1"
}
}Tasks / Kanban
Members work under Coord Tasks (Pending -> InProgress -> WaitingReview -> Completed). The leader accepts or rejects deliverables; on a member task submit, a synthetic re-dispatch routes the task back to the leader for review.
teams.create_task
Create a Coord Task for a member.
Request:
{
"jsonrpc": "2.0",
"id": 4,
"method": "teams.create_task",
"params": {
"team_id": "team-1",
"assignee": "reviewer",
"title": "Audit auth module for injection",
"description": "Check all query construction paths."
}
}teams.update_task
Update a task's status, assignee, or fields.
Request:
{
"jsonrpc": "2.0",
"id": 5,
"method": "teams.update_task",
"params": {
"team_id": "team-1",
"task_id": "task-7",
"status": "InProgress"
}
}| Method | Description |
|---|---|
teams.create_task | Create a Coord Task for a member |
teams.update_task | Update a task's status/assignee/fields |
teams.list_tasks | List tasks on a team's board |
teams.add_task_comment | Add a comment to a task |
teams.list_task_comments | List comments on a task |
teams.list_task_events | List a task's lifecycle events |
teams.list_task_runs | List execution runs for a task |
teams.list_templates | List available task templates |
teams.task.pause | Pause a running task |
teams.task.resume | Resume a paused task |
teams.task.retry | Retry a failed task |
teams.task.skip | Skip a task |
teams.task.trace | Fetch a task's execution trace |
teams.task.journal.get | Get a task's journal entry |
teams.task.journal.list | List a task's journal entries |
Snapshots
| Method | Description |
|---|---|
teams.snapshot.create | Create a snapshot of team state |
teams.snapshot.get | Get a single snapshot |
teams.snapshot.list | List snapshots for a team |
teams.snapshot.restore | Restore team state from a snapshot |
teams.snapshot.delete | Delete a snapshot |
Workflow
| Method | Description |
|---|---|
teams.workflow.export_canvas | Export the team workflow canvas |
teams.workflow.import_canvas | Import a workflow canvas |
teams.workflow.approve_step | Approve a workflow step |
teams.workflow.reject_step | Reject a workflow step |
teams.workflow.retry_step | Retry a workflow step |
ACP members
| Method | Description |
|---|---|
teams.acp_member.add | Add an ACP (external agent-client-protocol) member |
teams.acp_member.list | List ACP members on a team |
teams.acp_member.remove | Remove an ACP member |
Usage
teams.usage
Report usage (tokens, cost) for a team.
See Also
- Methods Reference -- All method namespaces
- group_chat.* -- Group-chat session primitive
- Architecture: Teams -- Team orchestration architecture