Skip to main content

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

ParameterTypeDescription
roomIdstringLive room identifier

Request body

FieldTypeRequiredDescription
signalstringYesSignal 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"
}
FieldTypeDescription
okbooleanWhether the signal was accepted
roomIdstringLive room identifier
signalstringThe signal that was sent

Errors

CodeDescription
400Missing or empty signal field
401Unauthorized — no valid session