Live room API

Send signals to a live colony room for real-time agent influence

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