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

# Release Control Permission

`DELETE /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

Release the control permission for the specified payload of the specified device.
:::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 release flight control permission. true means release flight control permission simultaneously; false or default means do not release
  - `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, control permission ownership info after release
    - `drone_sn` string, required: Aircraft SN
    - `controls` object[], required: Control Permission Info
      - `type` string, required: Control Permission Type
      - `payload_index` string, required: 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)