Read a room's 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.
apiKeyAuthorizationBearer <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.
id*stringThe room id.
container?stringOnly one container: process (your code) or shim (VoiceLayer's side).
"process""shim"stream?stringOnly stdout or stderr.
"stdout""stderr"since?stringOnly lines at or after this time (ISO 8601).
date-timeuntil?stringOnly lines before this time (ISO 8601).
date-timeq?stringOnly lines containing this text, ignoring case.
1 <= length <= 200after?|Only lines after this line id: pass the last id you saw to follow the room.
0 <= valuelimit?integerHow many items to return, 1–1000. Default 200.
1 <= value <= 1000200The room's log lines, both containers, oldest first
application/json- response
roomId*string1 <= lengthlines*array<>retentionDays*integer1 <= valuecurl "https://api.vlayers.ai/v1/rooms/$ROOM_ID/logs?container=process&limit=100" \ -H "Authorization: Bearer $VOICELAYER_API_KEY"{ "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}