Device Control Authority Operation

POST

/openapi/v2.0/manage/api/v1/projects/{uuid}/topologies/cmds/control

Project-level Multi-user Collaborative Operations on Device Control Authority — Apply, Preempt Queue, Cancel, Approve/Reject Transfer, Active Release; 6 actions total. Backend dispatches to corresponding business flows by control_operation_method; involves control authority state machine updates and async message notifications. Compared to organization-level API, this API's authentication domain is project, and holder call sign returns project nickname preferentially.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "control_operation_method": "apply_control_pre_preemptive_queue",
    "device_control_method": "device_cmd",
    "device_sn": "8UNDOCK0010002"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/manage/api/v1/projects//topologies/cmds/control' \
--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 '{
    "control_operation_method": "apply_control_pre_preemptive_queue",
    "device_control_method": "device_cmd",
    "device_sn": "8UNDOCK0010002"
}'

Responses

🟢200

application/json

Operation Successful

Bodyapplication/json

Example

{
    "code": 0,
    "message": "success",
    "data": {
        "device_control_status": 210243,
        "PrePreemptiveID": "pp-7e2a9f81",
        "PrePreemptiveUserID": "user-002",
        "PrePreemptiveMethod": "device_cmd",
        "PrePreemptiveTime": 1717890300,
        "PrePreemptiveExpirationTime": 1717890600
    }
}

🟠400

🔴500

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

Query User List in Project Recently Operating Device

Request Cloud Control Authorization (Initiated to Remote Controller)