> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Socket sessions

> Open, change, and end the sessions a white-label builder's browser uses to receive live updates

> [!WARNING]
>
> Socket sessions are in beta and available only to white-label workspaces on the [Builder plan or higher](https://docs.base44.com/Account-and-billing/Billing-and-plans.md) that have [live AI chat updates](https://docs.base44.com/developers/white-label/live-updates.md) turned on. Ask your onboarding contact to turn them on for your workspace.

A socket session lets a page in your product receive [live updates](https://docs.base44.com/developers/white-label/live-updates.md) for specific apps. Your server opens a session each time the page opens, with a workspace API key that has the **Watch app builder updates** permission. A session watches up to eight apps for one hour. Sessions are never extended.

Your server sends the session token to the browser, and the browser connects with the `@base44/platform` SDK. Create a client with [`createPlatformClient()`](https://docs.base44.com/developers/references/platform-sdk/docs/functions/createPlatformClient), then use its [`chat`](https://docs.base44.com/developers/references/platform-sdk/docs/interfaces/chat) module to receive the session's messages in your callbacks. Keep the session ID on your server to change which apps the session watches or to end it.

## Messages

* [Socket messages](https://docs.base44.com/developers/references/apps-api/sections/socket-messages.md): Every message on a session's connection, in both directions, and the fields it carries.

## Endpoints

* [Create socket session](https://docs.base44.com/api-reference/create-socket-session.md): Open a session for specific apps.
* [Add app to session](https://docs.base44.com/api-reference/add-app-to-session.md): Let the session watch one more app.
* [Remove app from session](https://docs.base44.com/api-reference/remove-app-from-session.md): Stop the session from watching an app.
* [End socket session](https://docs.base44.com/api-reference/end-socket-session.md): End the session and disconnect the browser.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.