Update In-Progress Fly-to-Target Task

PUT

/openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/fly-to-points

Dynamically modify waypoint sequence of executing fly-to task (e.g. add/remove / adjust intermediate points / change speed). Aircraft continues flight per new sequence when switching to next waypoint; no need to stop and resend. Concurrency Constraint: same fly_to_id cannot be updated concurrently; server uses lock based on fly_to_id to prevent concurrent overwrite. Prerequisite: Caller must hold target aircraft's flight control authority (consistent with initiator).

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "fly_to_id": "5dff27bd-693c-4ace-979d-e26e920d497a",
    "start_point": {
        "latitude": 22.5025,
        "longitude": 113.9422,
        "height": 100
    },
    "points": [
        {
            "latitude": 22.505,
            "longitude": 113.944,
            "height": 120
        },
        {
            "latitude": 22.5062,
            "longitude": 113.9448,
            "height": 100
        }
    ],
    "max_speed": 12
}

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/fly-to-points' \
--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 '{
    "fly_to_id": "5dff27bd-693c-4ace-979d-e26e920d497a",
    "start_point": {
        "latitude": 22.5025,
        "longitude": 113.9422,
        "height": 100
    },
    "points": [
        {
            "latitude": 22.505,
            "longitude": 113.944,
            "height": 120
        },
        {
            "latitude": 22.5062,
            "longitude": 113.9448,
            "height": 100
        }
    ],
    "max_speed": 12
}'

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

Initiate Fly-to-Multiple-Targets Task

End Fly-to-Target Task