Aleph
Gateway RPCMethods Reference

group_chat.*

Group chat and multi-party conversation RPC methods

Group chat methods manage multi-party conversations involving multiple AI agents and/or human participants in a shared chat context.

Methods

group_chat.list

List all active group chats.

Request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "group_chat.list",
  "params": {}
}

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "chats": [
      {
        "id": "gc-1",
        "name": "Project Planning",
        "participants": ["user", "planner", "coder"],
        "message_count": 42,
        "created_at": "2024-01-15T10:30:00Z"
      }
    ]
  }
}

group_chat.create

Create a new group chat.

Request:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "group_chat.create",
  "params": {
    "name": "Code Review",
    "participants": ["reviewer", "tester"]
  }
}

Response:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "chat": {
      "id": "gc-2",
      "name": "Code Review",
      "participants": ["user", "reviewer", "tester"],
      "created_at": "2024-01-15T10:30:00Z"
    }
  }
}

Parameters:

ParameterTypeRequiredDescription
namestringYesChat name
participantsstring[]YesAgent roles to include (user is always included)

group_chat.send

Send a message to a group chat.

Request:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "group_chat.send",
  "params": {
    "chat_id": "gc-1",
    "message": "What do you think about this approach?",
    "sender": "user"
  }
}

Response:

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "message_id": "msg-1",
    "responses": [
      {
        "from": "planner",
        "message": "This looks solid. I suggest..."
      },
      {
        "from": "coder",
        "message": "Implementation-wise, we could..."
      }
    ]
  }
}

group_chat.history

Get message history for a group chat.

Request:

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "group_chat.history",
  "params": {
    "chat_id": "gc-1",
    "limit": 50
  }
}

group_chat.add_participant

Add a participant to a group chat.

Request:

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "group_chat.add_participant",
  "params": {
    "chat_id": "gc-1",
    "participant": "documenter"
  }
}

group_chat.remove_participant

Remove a participant from a group chat.

Request:

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "group_chat.remove_participant",
  "params": {
    "chat_id": "gc-1",
    "participant": "tester"
  }
}

group_chat.delete

Delete a group chat.

Request:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "group_chat.delete",
  "params": {
    "chat_id": "gc-2"
  }
}

See Also

On this page