Skip to main content
PATCH
Update device

Authorizations

Authorization
string
header
required

A bearer token obtained through one of the two flows below.

Headers

Idempotency-Key
string

Optional. A UUID per logical operation, not per attempt: a retry carrying the same key gets the first attempt's answer back, headers and all, rather than performing the write twice. Honoured for 24 hours.

A refusal is an answer. A 422 is remembered like any other, so sending a corrected body under the same key answers 422 idempotency_key_reuse rather than accepting the correction — the point of a key is that one key means one decision. Use a new key for a new attempt at the request, and keep the old one only for retrying the same bytes after a timeout.

A 5xx is the exception: nothing was decided, so the key is released and the same one may be retried.

A replayed answer carries Idempotent-Replay: true.

Maximum string length: 191

Path Parameters

id
string
required

Body

application/vnd.api+json

A JSON:API document holding one resource.

data
object
required
included
object[]

Response

The registration.

A JSON:API document holding one resource.

data
object
required
included
object[]