Batch Modify Organization Device Call Sign

PUT

/openapi/v2.0/manage/api/v1/organizations/{uuid}/devices

Modify multiple organization devices' "Device Organization Call Sign" (i.e. display name of device from organization perspective) at once. Request body provides device_sn + device_callsign item by item; server processes each one by one; failed devices return their respective SNs and error codes in error_infos array; partial success/failure scenarios commonly occur when "call sign is already occupied by another device". Call Conditions: caller must be organization administrator/super administrator.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "devices": [
        {
            "device_sn": "3ABDQ12345678",
            "device_callsign": "Org A Aircraft"
        },
        {
            "device_sn": "2TUDK87654321",
            "device_callsign": "Org A Aircraft"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT '/openapi/v2.0/manage/api/v1/organizations//devices' \
--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 '{
    "devices": [
        {
            "device_sn": "3ABDQ12345678",
            "device_callsign": "Org A Aircraft"
        },
        {
            "device_sn": "2TUDK87654321",
            "device_callsign": "Org A Aircraft"
        }
    ]
}'

Responses

🟢200

application/json

Success

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": {
        "error_infos": [
            {
                "device_sn": "2TUDK87654321",
                "error_code": 213000
            }
        ]
    }
}

🟠400

🔴500

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

Query Organization Device Simplified List

Modify Single Organization Device Call Sign