Skip to content
handupbeta
Download

device_update

View as Markdown
PATCH
/v1/devices/{id}

Local only. Update enabled, push, or scope (view or decide); at least one field is required. Muting push preserves API/event access. Scope changes apply immediately. Disabled devices get 403 and their event WebSockets close with code 4403.

id
required
string
Media typeapplication/json
object
enabled
boolean | null
push
boolean | null
scope
One of:
null
Media typeapplication/json

A paired remote device. The bearer token itself is never stored; only its SHA-256 digest is (see remote::hash_token).

object
id
required
string
name
required
string
scope
required

view (read-only) or decide (adds decision, cancel and test requests).

string
enabled
required
boolean
push
required
boolean
created_at
required
integer format: int64
last_seen
integer | null format: int64

Invalid or empty body; submit scope cannot be changed

Unknown device