---
title: "Report how an app's realtime (live updates) connection is doing. Always 202 for a well-formed report."
method: POST
path: "/v1/account/auth/realtime-status"
tags: ["account"]
---

# Report how an app's realtime (live updates) connection is doing. Always 202 for a well-formed report.

`POST /v1/account/auth/realtime-status`

## Request

- Base URL: `https://api.thebridge.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebridge.dev/v1/account/auth/realtime-status`
- Auth: none declared. Required headers: `x-app-id`

## Headers

- `x-app-id` string, required

## Request body

- RealtimeStatusRequestDto
  - `state` 'connecting' | 'open' | 'degraded' | 'unauthorized' | 'closed' | 'idle', required: Connection state being reported.
  - `reason` string: Machine-readable reason for a refused or degraded connection (lowercase, digits, underscores).
  - `side` 'app' | 'bridge' | 'config' | 'network': Whose move it is to fix a refusal.
  - `ref` string: Client-side correlation id of the connection episode.

## Response `202`

---

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