Create Public Room
create_public_roomCreate a publicly discoverable room with a unique @handle. Counts toward the free-plan five-room cap.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"icon": "<icon>",
"color": "<color>",
"handle": "<handle>"
},
"name": "create_public_room"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| icon | Yes | A v3 room-icon catalog id, e.g. "bell". Call list_room_icons to discover the valid ids. | |
| name | Yes | Room display name. | |
| color | Yes | Hex color, e.g. "#e33122". | |
| handle | Yes | Globally unique @handle (vanity URL): lowercase letters, digits, underscores. | |
| category | No | Discovery category. | |
| show_owner | No | Whether the owner is shown publicly. Defaults to true. | |
| description | No | Short room description shown in public discovery. | |
| location_name | No | Place name shown in nearby discovery. Send all three location fields or none. | |
| location_latitude | No | Latitude in decimal degrees. Send all three location fields or none. | |
| location_longitude | No | Longitude in decimal degrees. Send all three location fields or none. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Purpose-built PingRoom result with credential and account fields removed. |