---
title: "Real-time inbox notifications (WebSocket)"
method: GET
path: "/v1/ws"
tags: ["websocket"]
---

# Real-time inbox notifications (WebSocket)

`GET /v1/ws`

## Request

- Base URL: `https://agentlair.dev`
- URL: `https://agentlair.dev/v1/ws`
- Auth: none required

Upgrade to a WebSocket connection for real-time inbox notifications. Authenticated via `?token=al_live_...` query parameter (Authorization headers are not supported for WebSocket upgrades). On successful upgrade, the server streams JSON notification events as they arrive.

## Query parameters

- `token` string, required

## Other responses

- `101`: Switching Protocols — WebSocket connection established
- `401`: Invalid or missing token

---

[API](https://skmtc.dev/agentlair/apis/agentlair-api.md) · [All operations](https://skmtc.dev/agentlair/apis/agentlair-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlair/apis/agentlair-api/revisions/fac95ff4995d?raw)