Create Flight Task

POST

/openapi/v2.0/flight-task

Create a wayline flight task. You can use the Wayline Upload Completion Notification interface to obtain the wayline UUID uploaded to FlightHub 2, then call this interface to create a wayline task

Request

Header Params

Body Params application/jsonRequired

Example

{
    "name": "flight_task_01",
    "sn": "8UUDMAQ00A0133",
    "wayline_uuid": "ef569c4c-dbab-4446-90ea-4ae8a2894daa",
    "time_zone": "Asia/Shanghai",
    "task_type": "immediate",
    "rth_altitude": 120,
    "rth_mode": "preset",
    "out_of_control_action_in_flight": "return_home",
    "wayline_precision_type": "rtk",
    "resumable_status": "manual",
    "repeat_type": "nonrepeating"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/flight-task' \
--header 'X-User-Token: {{X-User-Token}}' \
--header 'X-Project-Uuid: be1e0ee4-2a3e-4150-82ca-ec1d2626efa3' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Language: zh' \
--header 'X-Language: zh' \
--header 'Content-Type: application/json' \
--data '{
    "name": "flight_task_01",
    "sn": "8UUDMAQ00A0133",
    "wayline_uuid": "ef569c4c-dbab-4446-90ea-4ae8a2894daa",
    "time_zone": "Asia/Shanghai",
    "task_type": "immediate",
    "rth_altitude": 120,
    "rth_mode": "preset",
    "out_of_control_action_in_flight": "return_home",
    "wayline_precision_type": "rtk",
    "resumable_status": "manual",
    "repeat_type": "nonrepeating"
}'

Responses

🟢200

application/json

Success

Bodyapplication/json

Example

{
    "code": 0,
    "message": "",
    "data": {
        "task_uuid": "e8c18393-19e9-40b3-9f62-39583609cb03"
    }
}

🟠401

🟠403

🟠422

🔴500

Modified at 2026-05-26 14:32:15

Check Whether Flight Task Meets Dispatch Conditions

Resumable Immediate Task