Skip to main content
POST
Start streaming session
Starts a new log streaming session from an edge agent. The session will automatically terminate after the specified timeout.
After starting a session, connect to the WebSocket URL in the response to receive real-time logs.

Authorizations

Authorization
string
header
required

JWT token obtained from /auth/login

Body

application/json
agent_id
string<uuid>
required
timeout_seconds
integer
default:300

Auto-stop after this duration (default 5 minutes)

filter_query
string

Optional LogQL filter query

Response

Streaming session started

session_id
string<uuid>
agent_id
string<uuid>
status
string
websocket_url
string

Relative WebSocket URL for this session