Update Organization Device Shadow Configuration

Dispatch "Desired State" configuration to devices bound in organization; common uses include remote modification of device-level attributes like night flight light switch, track mode parameters, bay air conditioning temperature, supplementary light brightness, whether to enable landing assistance, etc. After dispatch, device responds at its discretion and syncs actual state to cloud. Semantics: This API's semantics is "Accept Configuration Change Dispatch Request" — dispatch is treated as acceptance success; actual effect determined by device response. state array can contain multiple {desired: {...}} groups; server executes serially in array order (devices do not support concurrent commands; cloud concurrency mostly fails); if previous desired fails, interrupts subsequent; not an atomic transaction. Authentication: caller must have organization-level access permission for devices in organization; for some sensitive attributes (e.g. bay forced cover open, etc.), must also currently hold control authority for the device (returns non-zero code without control authority; frontend guides user to preempt control authority first). This is the key difference from "Update Project Device Shadow Configuration" API (project level has no control authority check, but triggers flight record notification). Parameter Values: full attribute key list and value range for each attribute per corresponding model SDK documentation; this API is only the configuration dispatch channel; parameter value validity is validated by device side per model thing model.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Single Change — Turn On Aircraft Night Flight LightBatch Change — Set Bay Air Conditioning to 26°C + Set Supplementary Light Brightness to 80

{
    "device_sn": "3ABDQ12345678",
    "state": [
        {
            "desired": {
                "night_lights_state": 1
            }
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Request

Request Code Samples

Responses