Aleph
Gateway RPCMethods Reference

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.teams returns the team list augmented with a small members_preview and last_message per team (used to render the sidebar's "Group Chats" history). For the live group-chat session primitive, see group_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:

ParameterTypeRequiredDescription
leaderstringYesAgent id that plans and reviews member work
membersstring[]YesAgent ids working under assigned Coord Tasks
auto_namebooleanNoLet 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"
  }
}
MethodDescription
teams.create_taskCreate a Coord Task for a member
teams.update_taskUpdate a task's status/assignee/fields
teams.list_tasksList tasks on a team's board
teams.add_task_commentAdd a comment to a task
teams.list_task_commentsList comments on a task
teams.list_task_eventsList a task's lifecycle events
teams.list_task_runsList execution runs for a task
teams.list_templatesList available task templates
teams.task.pausePause a running task
teams.task.resumeResume a paused task
teams.task.retryRetry a failed task
teams.task.skipSkip a task
teams.task.traceFetch a task's execution trace
teams.task.journal.getGet a task's journal entry
teams.task.journal.listList a task's journal entries

Snapshots

MethodDescription
teams.snapshot.createCreate a snapshot of team state
teams.snapshot.getGet a single snapshot
teams.snapshot.listList snapshots for a team
teams.snapshot.restoreRestore team state from a snapshot
teams.snapshot.deleteDelete a snapshot

Workflow

MethodDescription
teams.workflow.export_canvasExport the team workflow canvas
teams.workflow.import_canvasImport a workflow canvas
teams.workflow.approve_stepApprove a workflow step
teams.workflow.reject_stepReject a workflow step
teams.workflow.retry_stepRetry a workflow step

ACP members

MethodDescription
teams.acp_member.addAdd an ACP (external agent-client-protocol) member
teams.acp_member.listList ACP members on a team
teams.acp_member.removeRemove an ACP member

Usage

teams.usage

Report usage (tokens, cost) for a team.

See Also

On this page