---
title: "Make Device Enter Relay Pairing Mode"
method: POST
path: "/openapi/v2.0/device/relay_model"
tags: ["Device Management/Device Configuration/Pairing Management", "Device Management"]
---

# Make Device Enter Relay Pairing Mode

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

## Request

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

Basic logic of relay pairing: relay device and operating controller. When pairing, be sure to mark the relay device and operating aircraft clearly. Do not randomly attempt pairing operations. If triggered by mistake, you can recover by rebooting devices and re-pairing

## Headers

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

## Request body

- object
  - `device_sn` string, required: Relay device SN (NOT the operating aircraft SN). Relay pairing is anchored on the relay device
  - `pair_enable` boolean, required: true = enter relay pairing mode; false = exit relay pairing mode. On exit, pair_type must still be correctly provided to clean up the corresponding side's binding
  - `pair_type` 'drone' | 'relay', required: Which side of the device this pairing operation targets: drone = operating-aircraft side (pair/unpair between the relay and an already-paired operating aircraft); relay = relay-device side (the relay's own pairing switch, e.g., putting the relay into pending-pair state first, then letting the operating aircraft scan to bind). If triggered by mistake, recover by rebooting the device and re-pairing

## Response `200`

- object
  - `code` string, required: Non-zero Indicates Exception
  - `message` string, required: Message Prompt
  - `data` unknown, required

## 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)