Update POI Orbit Speed

PUT

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

Dynamically adjust flight speed of executing POI orbit task; aircraft responds immediately; server synchronously updates speed record in database. If target aircraft participates in multi-aircraft collaboration (one-to-many) tasks, asynchronously syncs same speed to associated devices. Even if aircraft is not currently in POI orbit state, service still dispatches command and updates DB, but aircraft may reject.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "device_sn": "8UUDMAQ00A0152",
    "speed": 8
}

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/e3dea0f5-37f2-4d79-ae58-490af3228069/flight-tasks/poi-speed' \
--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",
    "speed": 8
}'

Responses

🟢200

application/json

Speed Update Command Dispatched and Persisted Successfully

Bodyapplication/json

Example

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

🟠400

🔴500

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

Exit POI Orbit Mode

Query POI Task Status