Modify Project Device Configuration Parameters

PUT

/openapi/v2.0/manage/api/v1/projects/{uuid}/devices/{sn}/configs

Important: Only one field can be set per call — only one of the four groups (common_config / flight_safe_config / payload_config / live_config) can be passed in request body; only one field can be set within the group; caller uses one-change-per-call strategy with multiple calls. Dock-type devices allow all four groups; RM510 Remote Controller-type devices only allow payload_config (others ignored). Linkage Constraints:

payload_config must also pass payload_index, and caller must hold control authority for that payload position

flight_safe_config triggers device sync; caller must hold flight control authority for that device; device sync is silently skipped when aircraft is offline, but project-side configuration is still saved

live_config has no control authority constraint. Field range/enum see oneOf three branches for details; out_of_control_action values: Hover / ReturnHome / Continue.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Modify Return AltitudeModify High Temperature Alert Threshold (payload_config + payload_index)Modify Livestream Weak Network ModeGeneric Device Configuration (Passthrough)

{
    "flight_safe_config": {
        "rth_altitude": 120
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Modify Return AltitudeModify High Temperature Alert Threshold (payload_config + payload_index)Modify Livestream Weak Network ModeGeneric Device Configuration (Passthrough)

curl --location --request PUT '/openapi/v2.0/manage/api/v1/projects/e11fdd52-cf40-4a81-a798-e49e73e51139/devices/2TUDK87654321/configs' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'X-Request-Id;' \
--header 'X-Request-Id;' \
--header 'X-Project-Uuid;' \
--header 'Content-Type: application/json' \
--data '{
    "flight_safe_config": {
        "rth_altitude": 120
    }
}'

Responses

🟢200

application/json

Success Response

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": null
}

🟠400

🔴500

Modified at 2026-06-15 13:36:31

Query Device SIM Card Subscription and Data Info

Get Project Device Configuration