External: Sync Status

Stream User Sync Status

Open a Server-Sent Events stream of sync status for a user.

The stream emits event: sync.status messages whose data payload is a JSON-encoded SyncStatusEvent. Heartbeats are sent every ~15 s as SSE comments (lines starting with :) to keep the connection alive across proxies.

Covers events from:

  • REST pull syncs (e.g. Whoop, Oura, Polar, Suunto)
  • Garmin webhook live + 30-day backfill
  • Mobile SDK uploads (Apple HealthKit, Samsung Health, Google)
  • Apple Health XML imports

The stream remains open until the client disconnects. EventSource in browsers reconnects automatically.

get/api/v1/users/{user_id}/sync/stream

Request

  • Base URL: https://api.openwearables.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.openwearables.io/api/v1/users/{user_id}/sync/stream
  • Auth: OAuth 2 (password, token URL /api/v1/auth/login)

Path parameters

user_idstring uuid required

Query parameters

replayinteger

Replay last N events on connect.

Headers

X-Open-Wearables-API-Keystring nullable

Response

Server-Sent Events stream of sync status updates.

Changes

No recorded changes to this operation across all 28 revisions of this API.