Query Flight Task List

GET

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

Multi-dimensional filtered query of flight task list under current project (V2). Supports filtering by task name, device SN, time range, task type, status, etc.; paginated return.

Request

Path Params

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff '/openapi/v2.0/task/api/v2/workspaces//flight-tasks?sn[]=undefined&name=undefined&begin_at=undefined&end_at=undefined&task_type=undefined&status[]=undefined&page=undefined&page_size=undefined&target_task_uuid=undefined&media_upload_type=undefined&source=undefined&flight_task_status=undefined&flight_task_type=undefined&list_type=undefined&auto_workflow=undefined' \
--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

Success Response

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": {
        "list": [
            {
                "task_uuid": "task-001-uuid",
                "task_name": "Inspection Task-20240115",
                "task_type": 2,
                "status": 3,
                "device_sn": "1ZNBJ1D00C00AX",
                "begin_time": 1700000000,
                "end_time": 1700003600
            }
        ],
        "pagination": {
            "page": 1,
            "page_size": 20,
            "total": 1
        }
    }
}

🟠400

🔴500

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

Update Flight Task Suspend Status (Suspend / Resume / Cancel)

Query Flight Sortie List with AI Alerts by Device SN