Create Relay Task (Dual-Aircraft Rotation)

POST

/openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/relay-missions

Create Relay Task (Dual-Aircraft Rotation): specify primary and backup aircraft to alternately execute the same flight task at a certain task point (when A is exhausted, switches to B; when B is exhausted, switches back to A); uniformly orchestrated by scheduling center. Typical Call Prerequisites:

POST /flight-tasks/relay-missions/positions — Calculate relay points first, then create task

POST /flight-tasks/device-recommendation (strategy_id=4) — Recommend dual-aircraft rotation device combination After creation, system automatically registers to scheduling center; automatically triggers primary/backup aircraft switch based on battery threshold. Call Requirements: Logged-in project member with flight task creation permission in workspace; the docks owned by primary and backup aircraft must both not be in other flight task execution.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "main_drone_sn": "1ZNBJ5D0030S2P",
    "secondary_drone_sn": "1ZNBJ5D0030S3Q",
    "mission_position": {
        "latitude": 22.5431,
        "longitude": 113.9342,
        "height": 100
    },
    "end_at": 1735689600,
    "out_of_control_action": "ReturnHome",
    "main_rth_altitude": 120,
    "secondary_rth_altitude": 120,
    "early_departure_time": 300,
    "flight_id": "flight-1234"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/task/api/v1/workspaces//flight-tasks/relay-missions' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'X-Request-Id: 5dff27bd-693c-4ace-979d-e26e920d497a' \
--header 'X-Request-Id;' \
--header 'X-Project-Uuid;' \
--header 'Content-Type: application/json' \
--data '{
    "main_drone_sn": "1ZNBJ5D0030S2P",
    "secondary_drone_sn": "1ZNBJ5D0030S3Q",
    "mission_position": {
        "latitude": 22.5431,
        "longitude": 113.9342,
        "height": 100
    },
    "end_at": 1735689600,
    "out_of_control_action": "ReturnHome",
    "main_rth_altitude": 120,
    "secondary_rth_altitude": 120,
    "early_departure_time": 300,
    "flight_id": "flight-1234"
}'

Responses

🟢200

application/json

Operation Successful

Bodyapplication/json

Example

{
    "code": 0,
    "message": "success",
    "data": null
}

🟠400

🔴500

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

Query POI Task Status

Calculate Best Relay Position for Relay Task