streamSession

GET

/api/v1/sessions/{sessionId}/stream

WebSocket. The server sends every event after after as a JSON text message (a SessionEvent), then live events as they happen. After a reconnect, pass the last seq received to continue without gaps. {"type":"status","running":bool} messages report whether a turn runs; {"type":"presence","viewers":[{id,name,avatarUrl,role}]} lists who is watching.

streamSession

curl --request GET \
  --url '<base-url>/api/v1/sessions/<sessionId>/stream' \
  --cookie 'agenthold_session=<agenthold_session>'

const url = '<base-url>/api/v1/sessions/<sessionId>/stream';
const options = {
  method: 'GET',
  headers: {cookie: 'agenthold_session=<agenthold_session>'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "<base-url>/api/v1/sessions/<sessionId>/stream"

headers = {"cookie": "agenthold_session=<agenthold_session>"}

response = requests.get(url, headers=headers)

print(response.text)

Response example

{
  "error": "string"
}

Authorization

session
optional
API key in cookie

token
optional
HTTP Bearer
Authorization: Bearer <token>

Path parameters

sessionId
string
required

Query parameters

after
optional
integer
format: int64

Returns

101

Switching to WebSocket.

404

Error.

JSON

error
string
required