Edit Flight Task

PUT

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

Edit flight plan: overwrite-update task rule fields (time, repeat, device, wayline, lost-control action, VLM configuration, etc.). Scope: Only pending (not yet dispatched to device) scheduled tasks, recurring subtasks, and continuous subtasks can be edited. Immediate tasks, test flight tasks, and breakpoint resume tasks cannot be edited.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "task_type": 2,
    "repeat_type": 0,
    "interval": 1,
    "dom": [
        1
    ],
    "dow": [
        1
    ],
    "time_zone": "string_value",
    "sn": "1ZNBH1D00B00GX",
    "name": "example_name",
    "resumable_status": "auto",
    "out_of_control_action_in_flight": 1,
    "rth_altitude": 1,
    "wayline_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT '/openapi/v2.0/task/api/v1/workspaces//flight-tasks/' \
--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 '{
    "task_type": 2,
    "repeat_type": 0,
    "interval": 1,
    "dom": [
        1
    ],
    "dow": [
        1
    ],
    "time_zone": "string_value",
    "sn": "1ZNBH1D00B00GX",
    "name": "example_name",
    "resumable_status": "auto",
    "out_of_control_action_in_flight": 1,
    "rth_altitude": 1,
    "wayline_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}'

Responses

🟢200

application/json

Success

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": {}
}

🔴500

🟠400

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

Delete Flight Task

Get Flight Task Details