Export Flight Task Records (Generates Async ZIP Task)

POST

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

Export specified flight task records by file type (default Excel format). Export is async task: this API creates an export task and returns task_id; client polls GET /flight-tasks/export to view progress. After completion, download ZIP from object_key field. In exported Excel detail report, when metrics includes position_info, three additional altitude columns are output:

Ellipsoid Height (HAE): WGS84 ellipsoid altitude reported by flight controller; has value only with RTK fixed solution

Altitude Relative to Takeoff (ALT): HAE minus takeoff point ellipsoid altitude

Above Ground Level (AGL): HAE minus ground elevation

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "flight_task_ids": [
        "string_value"
    ],
    "file_name": "example_name",
    "file_type": [
        "PDF"
    ],
    "content_type": "summary",
    "metrics": [
        "string_value"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/task/api/v2/workspaces//flight-tasks/export' \
--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 '{
    "flight_task_ids": [
        "string_value"
    ],
    "file_name": "example_name",
    "file_type": [
        "PDF"
    ],
    "content_type": "summary",
    "metrics": [
        "string_value"
    ]
}'

Responses

🟢200

application/json

Success

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": {
        "task_id": "export-002"
    }
}

🔴500

🟠400

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

Query Flight Task Export History

Cancel / Delete Export Task