Browser sessions

Managed browser lifecycle events expose only the public Novo browser session id (brsess_*) and status. Fetch live-view URLs just-in-time from your server:

const liveView = await novo.browserSessions.liveView('brsess_...');

| SDK | HTTP | |---|---| | novo.browserSessions.liveView(sessionId) | GET /v1/browser-sessions/:sessionId/live-view |

Live view

GET /v1/browser-sessions/brsess_123/live-view
Authorization: Bearer novo_ag_...

Response:

{
  "object": "browser_live_view",
  "sessionId": "brsess_123",
  "status": "active",
  "liveViewUrl": "https://...",
  "pages": [
    {
      "pageId": "page_0",
      "title": "Example",
      "active": true,
      "liveViewUrl": "https://..."
    }
  ]
}

liveViewUrl values are control-capable bearer URLs. They are returned only by this authenticated API, never in streams, signed callbacks, durable session rows, or model-visible tool output. Responses include Cache-Control: private, no-store, Pragma: no-cache, Expires: 0, and Vary: Authorization.

404 browser_session_not_found means the session does not exist in your organization, is closed, or is not active.