Trigger Relay Aircraft Active Takeoff

POST

/openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/relay-missions/{relay_mission_id}/active-takeoff

During relay task execution, under normal conditions, the relay aircraft is automatically launched by the scheduling center based on early_departure_time and primary aircraft battery. This API provides "Active Takeoff" capability — when relay aircraft is still in pending-scheduling state (relay_status=0 Pending Scheduling), caller manually triggers relay aircraft takeoff to relay point and wait. Call Prerequisites (must simultaneously satisfy):

Relay task overall status is running (Executing)

Relay scheduling status is 0 Pending Scheduling (relay aircraft has not taken off)

Relay aircraft currently standby in its own dock (in-bay state) Call Requirements: Logged-in project member with flight task execution permission in workspace. Request Body: This API does not require request body; body can be omitted or empty object {} passed.

Request

Path Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/openapi/v2.0/task/api/v1/workspaces//flight-tasks/relay-missions/12345/active-takeoff' \
--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;'

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

Edit Relay Task Configuration

Update Relay Task Running Status (Pause / Resume / Cancel)