[Callback] User disconnected

Designing

Staging

POST

/internal/collab/user-disconnected

Callbacks

Collab-plane → Control-plane callback.

Sent when a user's WebSocket connection to the Yjs document is lost. The control-plane
uses this to:

Update participant presence status

Start a reconnection grace period (US-11)

Trigger cleanup if the user does not reconnect within the timeout

Request

Authorization

API Key

Add parameter in header

X-Internal-Secret

Example:

X-Internal-Secret: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Disconnect acknowledged

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/internal/collab/user-disconnected' \
--header 'X-Internal-Secret: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "roomId": "550e8400-e29b-41d4-a716-446655440000",
    "userId": "660e8400-e29b-41d4-a716-446655440001",
    "timestamp": 1709467260000
}'

Response Example

{
    "success": true
}

Modified at 2026-03-11 21:59:03

[Callback] Snapshot ready

CreateDocumentRequest