Acquire (Occupy) Cloud Control Role

POST

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

Current user requests and occupies a cloud control role (e.g. flight_control / payload_control) for specified dock / aircraft. After successful occupation, the role becomes held by "Cloud Control"; all related users immediately receive WebSocket real-time change notification.

This API is the 0.9 compatibility version. New business is recommended to use POST /openapi/v2.0/drc/api/v1/projects/{uuid}/cloud_controls. Corresponding release API: DELETE /openapi/v2.0/manage/api/v1/projects/{uuid}/drc/roles.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "device_sn": "8UNDOCK0010002",
    "role": {
        "name": "flight_control",
        "spec": {
            "locked": false
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/manage/api/v1/projects//drc/roles' \
--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 '{
    "device_sn": "8UNDOCK0010002",
    "role": {
        "name": "flight_control",
        "spec": {
            "locked": false
        }
    }
}'

Responses

🟢200

application/json

Operation Successful

Bodyapplication/json

Example

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

🟠400

🔴500

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

Query Device Control Authority Status (Organization Device O&M)

Query Project Device Control Authority Status