> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentbot.raveculture.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Live room API

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

# Live room API

<Warning>The live room API is deprecated and will be removed in a future release.</Warning>

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)

```http theme={"dark"}
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

```bash theme={"dark"}
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

```json theme={"dark"}
{
  "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 |