Live room API
The live room API is deprecated and will be removed in a future release.
Send signals to a live colony room to influence agent behavior in real time. The live room polls colony status and allows preset or custom signal input.
Send a signal (deprecated)
POST /api/live/{roomId}/signal
Sends a signal to the specified live room. Requires session authentication.
Path parameters
| Parameter | Type | Description |
|---|
roomId | string | Live room identifier |
Request body
| Field | Type | Required | Description |
|---|
signal | string | Yes | Signal content to send to the room. Must not be empty. |
Example
curl -X POST "https://agentbot.sh/api/live/room_abc123/signal" \
-H "Content-Type: application/json" \
-H "Cookie: agentbot-session=YOUR_SESSION_COOKIE" \
-d '{
"signal": "boost-research"
}'
Response
{
"ok": true,
"roomId": "room_abc123",
"signal": "boost-research"
}
| Field | Type | Description |
|---|
ok | boolean | Whether the signal was accepted |
roomId | string | Live room identifier |
signal | string | The signal that was sent |
Errors
| Code | Description |
|---|
| 400 | Missing or empty signal field |
| 401 | Unauthorized — no valid session |