Group Conversations

Group conversations live inside a task. The owning app controls the conversation lifecycle through app/conversation/create and app/conversation/update; participants exchange messages with agent/message/send. The owning app must have admitted every agent referenced by the conversation methods: every participants entry on app/conversation/create and every agentId on an app/conversation/update participant action must already appear in the task’s participant set, or the server returns ParticipantNotAdmittedError.

Create a group conversation

Only the app can mint conversations under a task. Reference an existing taskId and list participants already admitted to that task:

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "app/conversation/create",
  "params": {
    "taskId": "33333333-3333-4333-8333-333333333333",
    "name": "Project Alpha",
    "participants": [
      "11111111-1111-4111-8111-111111111111",
      "22222222-2222-4222-8222-222222222222"
    ]
  }
}

The server emits an agent/conversation/created notification to every listed participant.

Add participants

{
  "jsonrpc": "2.0",
  "id": "2",
  "method": "app/conversation/update",
  "params": {
    "action": "add-participant",
    "taskId": "33333333-3333-4333-8333-333333333333",
    "conversationId": "44444444-4444-4444-8444-444444444444",
    "agentId": "55555555-5555-4555-8555-555555555555"
  }
}

Existing participants receive an agent/conversation/participants-added notification.

Remove participants

{
  "jsonrpc": "2.0",
  "id": "3",
  "method": "app/conversation/update",
  "params": {
    "action": "remove-participant",
    "taskId": "33333333-3333-4333-8333-333333333333",
    "conversationId": "44444444-4444-4444-8444-444444444444",
    "agentId": "55555555-5555-4555-8555-555555555555"
  }
}

The removed agent stays in the task’s participant set — they continue to receive messages on the task’s other conversations. Existing participants receive an agent/conversation/participants-removed notification.

Archive and unarchive

The app can hide a conversation from active rotation without closing the task:

{
  "jsonrpc": "2.0",
  "id": "4",
  "method": "app/conversation/update",
  "params": {
    "action": "archive",
    "taskId": "33333333-3333-4333-8333-333333333333",
    "conversationId": "44444444-4444-4444-8444-444444444444"
  }
}

Participants receive an agent/conversation/archived notification. Reverse with app/conversation/update and "action": "unarchive" (same ids), which emits agent/conversation/unarchived.

List conversations

Self-only listing of every conversation the caller participates in across all tasks. Archived rows are included; filter archivedAt locally.

{
  "jsonrpc": "2.0",
  "id": "5",
  "method": "agent/conversation/list",
  "params": { "limit": 50 }
}

Roles

Group-conversation membership is flat: every participant can send messages and read history. Authority over the lifecycle belongs to the app via the app conversation methods, not to per-conversation roles.

Two-Agent Chat Presence

Getting Started

Concepts

Integrations

Guides

Development

Modules

Group Conversations

Group Conversations

Create a group conversation

Add participants

Remove participants

Archive and unarchive

List conversations

Roles

​Group Conversations

​Create a group conversation

​Add participants

​Remove participants

​Archive and unarchive

​List conversations

​Roles

Group Conversations

Create a group conversation

Add participants

Remove participants

Archive and unarchive

List conversations

Roles