Skip to main content

Update device

PATCH 
/workspaces/:id/devices/:device_id

Update mutable device fields. Only provided properties are updated. config_overrides is deep-merged (partial updates). Nested objects merge recursively; scalars and arrays are replaced. Send null to remove a key. Triggers MQTT config delivery. Custom attributes patch behavior:

  • Send "value": null to delete the stored value for that field_key.
  • If an element is present with no value (property absent), it is ignored (no change). Status change side effects:
  • When changing status to disabled or deleted, the linked MQTT principal is disabled (best effort).
  • When changing status to active, the principal is not automatically re-enabled.

Request​

Responses​

Updated device (same shape as detail response; state is omitted).