Fly to Target Point (One-Click Takeoff)

POST

/openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/drone-take-off

Make aircraft directly take off from specified dock / takeoff device, and optionally immediately fly to target point ("Takeoff + Point" in one go). Commonly used for clicking target point on map → one-click dispatch aircraft to perform viewing / shooting. Prerequisite: Caller must first obtain target aircraft's flight control authority. Returns: Created command task identifier flight_id and takeoff-embedded fly-to subtask fly_to_id.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "device_sn": "8UUDMAQ00A0152",
    "media_folder_name": "patrol-2026-06-05",
    "security_takeoff_height": 50,
    "max_speed": 12,
    "out_of_control_action": "ReturnHome",
    "rth_altitude": 100,
    "target_height": 100,
    "target_latitude": 22.50203,
    "target_longitude": 113.94186,
    "takeoff_mode": "TakeoffWithFlyTo",
    "commander_flight_mode": 0,
    "rth_mode": 0
}

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/drone-take-off' \
--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 '{
    "device_sn": "8UUDMAQ00A0152",
    "media_folder_name": "patrol-2026-06-05",
    "security_takeoff_height": 50,
    "max_speed": 12,
    "out_of_control_action": "ReturnHome",
    "rth_altitude": 100,
    "target_height": 100,
    "target_latitude": 22.50203,
    "target_longitude": 113.94186,
    "takeoff_mode": "TakeoffWithFlyTo",
    "commander_flight_mode": 0,
    "rth_mode": 0
}'

Responses

🟢200

application/json

Operation Successful

Bodyapplication/json

Example

{
    "code": 0,
    "message": "success",
    "data": {
        "flight_id": "f3a1b2c4-9c2e-4f10-9b1d-3c2a8e7f0e11",
        "fly_to_id": "5dff27bd-693c-4ace-979d-e26e920d497a"
    }
}

🟠400

🔴500

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

Get Flight Task Device Recommendation Result

Initiate Fly-to-Multiple-Targets Task