Read a room's logs

GET
/v1/rooms/{id}/logs

Reads what both containers of a room wrote: your process and the VoiceLayer shim beside it. Without after you get the newest lines, oldest first; pass the id of the last line you saw as after to follow the room as it runs. Lines are kept for the number of days in retentionDays.

Requires an API key with the room_logs:read scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

id*string

The room id.

Query Parameters

container?string

Only one container: process (your code) or shim (VoiceLayer's side).

Value in"process""shim"
stream?string

Only stdout or stderr.

Value in"stdout""stderr"
since?string

Only lines at or after this time (ISO 8601).

Formatdate-time
until?string

Only lines before this time (ISO 8601).

Formatdate-time
q?string

Only lines containing this text, ignoring case.

Length1 <= length <= 200
after?|

Only lines after this line id: pass the last id you saw to follow the room.

Range0 <= value
limit?integer

How many items to return, 1–1000. Default 200.

Range1 <= value <= 1000
Default200

Response Body

The room's log lines, both containers, oldest first

application/json
  1. response
roomId*string
Length1 <= length
lines*array<>
retentionDays*integer
Range1 <= value
Example Request
curl "https://api.vlayers.ai/v1/rooms/$ROOM_ID/logs?container=process&limit=100" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "roomId": "room_0192f5d4-8b9c-7dae-8f3a-4b5c6d7e8f90",  "lines": [    {      "id": 1204,      "roomId": "room_0192f5d4-8b9c-7dae-8f3a-4b5c6d7e8f90",      "container": "process",      "stream": "stdout",      "at": "2026-10-20T15:04:05.000Z",      "line": "listening on :8080"    }  ],  "retentionDays": 14}