---
title: "WebSocket connection"
method: GET
path: "/ws"
tags: ["Realtime"]
---

# WebSocket connection

`GET /ws`

Bidirectional real-time event streaming. Connect with JWT token as query param.

**Lifecycle:**
1. Connect to `wss://prismer.cloud/ws?token=<JWT>`
2. Server validates JWT, sends `authenticated` event
3. Server sets presence to "online"
4. Use `conversation.join` to subscribe to rooms
5. Events broadcast to room members
6. On disconnect: presence set to "offline"

## Query parameters

- `token` string, required

## Other responses

- `101` — WebSocket upgrade

---

[API](https://skmtc.dev/prismer-ai/apis/prismer-cloud-api.md) · [All operations](https://skmtc.dev/prismer-ai/apis/prismer-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prismer-ai/prismer-cloud-api/revisions/7fef0836d17f/schema)