Report this device as reachable
Call every 30 seconds while the app is able to take calls. A device that stops beating leaves the extension's fan-out within about a minute; the line's other devices are unaffected.
Authorization
deviceAuth A per-device secret issued by POST /v1/devices/enroll, presented as
Authorization: Device <secret>.
A distinct scheme rather than another bearer flavour: the bearer namespace already carries workspace API keys and session JWTs, and a device secret authorises far less than either — it can mint a WebRTC token for its own identity and report presence, and nothing else.
In: header
Response Body
curl -X POST "https://example.com/v1/devices/presence"Forget where to wake this device DELETE
Call on sign-out, or when notification permission is withdrawn. A token left behind that can no longer ring is not harmless: every wake attempt against it is silent waste. Revoking a device clears its token too.
Report this device as unreachable DELETE
Call on teardown so the device leaves the fan-out immediately rather than ringing out for up to one heartbeat interval.