---
title: "Acquire Control Permission"
method: POST
path: "/openapi/v2.0/device/control"
tags: ["Device Management"]
---

# Acquire Control Permission

`POST /openapi/v2.0/device/control`

## Request

- Base URL: `` (relative, and it does not resolve against the document’s source URL)
- URL: `/openapi/v2.0/device/control`
- Auth: none required

If you need to operate on the payload of a specific aircraft, you must first acquire the control permission for that payload device, then operate on it - for example, switching the lens of an aircraft's payload camera.

:::tip[]
The payload_index parameter can be obtained from data.list.drone.camera_list.camera_index in the device list.
:::

## Headers

- `X-Request-Id` string, uuid
- `X-Language` 'zh' | 'en'
- `X-Project-Uuid` string, required
- `X-User-Token` string, required

## Request body

- object
  - `drone_sn` string, required: Aircraft SN
  - `flight` boolean: Whether to acquire flight control permission. true means acquire flight control permission simultaneously (for sending waylines, takeoff, and other flight commands); false or default means do not acquire
  - `payload_index` string[]: Payload index. This parameter can be obtained from data.list.drone.camera_list.camera_index in the device list

## Response `200`

- object
  - `code` integer, required: Non-zero Indicates Exception
  - `message` string, required: Message Prompt
  - `data` object, required: Business data, aircraft and payload control permission ownership info
    - `drone_sn` string, required: Aircraft SN
    - `controls` object[], required: Control Permission Info
      - `type` string, required: Control permission type: flight means flight control permission, payload means payload control permission
      - `payload_index` string: Payload Index
      - `gateway` object, required: Gateway Info
        - `sn` string, required: Gateway SN, e.g., Dock SN
      - `user` object, required: User Info
        - `call_sign` string, required: User Alias
        - `user_id` string, required: User ID
        - `type` string, required: Control permission type, Cloud means cloud control

## Other responses

- `400`: Invalid request parameters (incorrect format, missing required fields, etc.)
- `401`: Authentication failed (token invalid or expired)
- `403`: Insufficient permission (token does not have the corresponding permission in this project/organization)
- `500`: Server Internal Error

---

[API](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud.md) - [All operations](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/revisions/aeef0010be34?raw)