Release Cloud Control Permission

DELETE

/openapi/v2.0/drc/api/v1/projects/{uuid}/cloud_controls

Voluntarily release currently held specified aircraft cloud control authority; releases at control_keys granularity; can simultaneously release flight and multiple payload_{index}. After release, next waiter can take over; all related users receive WebSocket real-time change notification (reason=Release).

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "drone_sn": "1ZNBHJD0010012",
    "control_keys": [
        "flight",
        "payload_53-0-0"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE '/openapi/v2.0/drc/api/v1/projects//cloud_controls' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'X-Request-Id: 5dff27bd-693c-4ace-979d-e26e920d497a' \
--header 'X-Request-Id;' \
--header 'X-Project-Uuid;' \
--header 'Content-Type: application/json' \
--data '{
    "drone_sn": "1ZNBHJD0010012",
    "control_keys": [
        "flight",
        "payload_53-0-0"
    ]
}'

Responses

🟢200

application/json

Operation Successful

Bodyapplication/json

Example

{
    "code": 0,
    "message": "success",
    "data": {
        "drone_sn": "1ZNBHJD0010012",
        "controls": [
            {
                "key": "flight",
                "type": "flight",
                "version": 1717890261333,
                "gateway": {
                    "sn": "",
                    "id": "",
                    "auth_control_keys": [],
                    "device_model_class": ""
                },
                "user": {
                    "call_sign": "",
                    "user_id": "",
                    "type": ""
                },
                "spec": {
                    "is_locked": false
                }
            },
            {
                "key": "payload_53-0-0",
                "type": "payload",
                "version": 1717890261333,
                "gateway": {
                    "sn": "",
                    "id": "",
                    "auth_control_keys": [],
                    "device_model_class": ""
                },
                "user": {
                    "call_sign": "",
                    "user_id": "",
                    "type": ""
                },
                "spec": {
                    "payload_index": "53-0-0"
                }
            }
        ]
    }
}

🟠400

🔴500

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

Acquire (Occupy) Cloud Control Permission

Dispatch Payload Control Command