---
title: "Aircraft Lens Switch"
method: POST
path: "/openapi/v2.0/device/change-lens"
tags: ["Real-time Control/Payload Control/Camera Control", "Device Management"]
---

# Aircraft Lens Switch

`POST /openapi/v2.0/device/change-lens`

## Request

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

Supports switching the aircraft camera lens between wide-angle, zoom, and infrared.
:::tip[]
- You must first call the `Acquire Control Permission` interface to obtain aircraft control permission before switching the aircraft lens.
- camera_index and lens_type can be obtained from data.list.drone:.camera_list in the Get Device List Under Organization interface.
:::

## Headers

- `X-User-Token` string, required
- `X-Project-Uuid` string, required
- `X-Request-Id` string
- `X-Language` string

## Request body

- object
  - `sn` string, required: Aircraft SN
  - `camera_index` string, required: Camera Index
  - `lens_type` string, required: Lens Type

## Response `200`

- object
  - `code` integer: Non-zero Indicates Exception
  - `message` string: Message Prompt

## Other responses

- `400`: Invalid Request Parameters
- `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)