1. Task Query
FlightHub 2 OpenAPI V2.0 (Public Cloud)
  • FlightHub 2 OpenAPI V2.0
    • Usage Guide
      • Authentication Tutorial
      • Error Code
    • Common
      • Common Tutorial
      • System Health & Access
        • Query FlightHub 2 System Status
        • Query System Health Status
        • Get Project Storage Upload STS Credentials
      • Security
        • SN Decrypt Echo
    • Organization & Project
      • Organization & Project Tutorial
      • Members & Permissions Management
        • Project Members
          • Add Members to Project
          • Get Project User List
          • Get Project Independent Member List
        • Organization Members
          • Get Organization User List
          • Get Current User's Organization Role
        • Roles & Permissions
          • Get Role List
          • Get Permission List
          • Get Role Permissions
      • Project Management
        • Project Collaboration
          • Get Project Quick-Join Information
        • Project Configuration
          • Get Auto Recording Config
        • Project Basic Info
          • Get Project List Under Organization
      • Organization Management
        • Organization Basic Info
          • Get Organization List
          • Get Organization Details
    • Device Management
      • Device Management Tutorial
      • Device List Management
        • Device List (Organization Scope)
          • Get Device List Under Organization
        • Device List (Project Scope)
          • Get Project Device Details
          • Get Project Device List
          • Update Device's Bound Project
          • Get Project Device History Topology
      • Device Configuration
        • Calibration & Positioning
          • Custom Network RTK Calibration
        • Pairing Management
          • Query Relay Pairing Result
          • Make Device Enter Relay Pairing Mode
      • Get HMS Information
      • Acquire Control Permission
      • Release Control Permission
      • Live View Quality Settings
      • Get Thing Model
    • Real-time Control
      • Real-time Control Tutorial
      • Control Permission Management
        • Device Control Permission
          • Query Device Control Status (Organization Device )
          • Query Device Control Status (Project Device)
        • Cloud Control Permission
          • Get Cloud Control Status
      • Payload Control
        • Camera Control
          • Aircraft Lens Switch
          • Dock Camera Switch
      • Flight Control Commands
        • General Real-time Commands
          • Query Device Command Execution
          • Send Real-time Control Command
      • Takeoff/Landing Coordination
        • Query Takeoff/Landing Coordination Area (TCA) Real-time Status
    • Livestream
      • Livestream Tutorial
      • Query Recording Tasks
        • Get Recording Tasks for Project Device
        • Get Recording Tasks for Organization Device
      • Livestream Sharing & Forwarding
        • Bypass Streaming
          • Create Stream Converter
          • Get Stream Converter List
          • Delete Stream Converter
          • Enable/Disable Stream Converter
        • Livestream Sharing
          • Get Device Livestream Share Details
          • Get Device Livestream Share List
      • Livestream Push
        • Start Livestream
    • Flight Task
      • Flight Task Tutorial
      • AI Flight Alerts
        • Query Flight Task Alert Records
        • Query AI Alert Records
      • Task Creation
        • Check Whether Flight Task Meets Dispatch Conditions
        • Create Flight Task
        • Resumable Immediate Task
      • Task Query
        • Get Recent Flight Task List
          GET
        • Get Default Task Name on Creation
          GET
        • Get Flight Task List
          GET
        • Get Flight Task Track Information
          GET
        • Get Wayline Task Details
          GET
        • Get Flight Task Information
          GET
        • Get Flight Task List
          GET
        • Get Media Resources from Flight Task
          GET
      • Flight Record
        • Get Export History
        • Get Single Flight Record Download Link
        • Get Wayline Task Operation Log
      • Task Update
        • Update Flight Task Status
    • Wayline
      • Wayline Tutorial
      • Wayline Management
        • Wayline Query
          • Get Wayline Details
          • Get Wayline List Under Project
        • Wayline Upload
          • Wayline Upload Completion Notification
    • Map
      • Map Tutorial
      • Map Annotation
        • Annotation Creation
          • Create Map Annotation
        • Annotation Update
          • Annotation Update
        • Annotation Deletion
          • Annotation Deletion
      • Airspace Safety
        • Terrain Obstacles
          • Get Offline Map URL
          • Get Offline Map Details
        • Custom Flight Area
          • Get Flight Area List (Workspace Scope)
          • Get Flight Area File URL
          • Get Flight Area List (Project Scope)
      • Airspace Warning
        • Airspace Warning
    • Model Reconstruction
      • Model Reconstruction Tutorial
      • Get Project Model List
      • Model Reconstruction
      • Get Model Details
      • Get Model File Download Link
    • Open Modeling
      • Open Modeling Tutorial
      • Start Reconstruction Task
      • Get Model Details
      • Delete Model
      • Stop Reconstruction Task
      • Get Resource Details
      • Delete Resource
      • Get Upload Credentials
      • Upload Callback
      • Get In-Progress Reconstruction Model Details
  1. Task Query

Get Wayline Task Details

GET
/openapi/v2.0/flight-task/detail
Query flight task details by flight_id (waypoints / name / template type, etc.)

Request

Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/openapi/v2.0/flight-task/detail?workspace_id=be1e0ee4-2a3e-4150-82ca-ec1d2626efa3&task_uuid=0543388c-1ed9-4915-beac-4d8b47fa16ef' \
--header 'X-User-Token: {{X-User-Token}}' \
--header 'X-Project-Uuid: be1e0ee4-2a3e-4150-82ca-ec1d2626efa3' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Language: zh' \
--header 'X-Language: zh'

Responses

🟢200
application/json
Success
Bodyapplication/json

Example
{
    "code": 0,
    "message": "",
    "data": {
        "begin_at": "2026-04-22T06:43:43.868237Z",
        "end_at": "2026-04-22T06:46:17.67932Z",
        "create_at": "2026-04-22T06:43:43.868237Z",
        "run_at": "2026-04-22T06:43:43.868237Z",
        "completed_at": "2026-04-22T06:46:17.67932Z",
        "flight_pieces": [
            {
                "ID": 721058,
                "created_at": "2026-04-22T06:43:43.868237Z",
                "begin_at": "2026-04-22T06:43:43.868237Z",
                "end_at": "2026-04-22T06:46:17.67932Z",
                "flight_task_id": "0543388c-1ed9-4915-beac-4d8b47fa16ef",
                "flight_piece_id": "0543388c-1ed9-4915-beac-4d8b47fa16ef",
                "take_off_airport_sn": "7CTDL9K00A0035",
                "land_airport_sn": "",
                "task_type": 2,
                "type": "manual",
                "status": "success",
                "flight_task_type": 2,
                "task_flight_type": "manual",
                "task_flight_status": "completed",
                "flight_task_status": 2,
                "task_status": 5,
                "task_name": "FlyToTask_7CTDL9K00A0035",
                "user_id": "1564883503387430912",
                "prj_uuid": "be1e0ee4-2a3e-4150-82ca-ec1d2626efa3",
                "wayline_uuid": "",
                "cloud_to_cloud_id": "",
                "source": 0,
                "workflow_uuid": "",
                "exception": null,
                "run_at": "2026-04-22T06:43:43.868237Z",
                "completed_at": "2026-04-22T06:46:17.67932Z",
                "flight_records": [
                    {
                        "ID": 26275,
                        "CreatedAt": "2026-04-22T06:46:18.517131Z",
                        "flight_piece_id": "0543388c-1ed9-4915-beac-4d8b47fa16ef",
                        "upload_sn": "7CTDL9K00A0035",
                        "flight_record_path": "fh/projects/be1e0ee42a3e415082caec1d2626efa3/flights/0543388c1ed94915beac4d8b47fa16ef/flight_replay_7CTDL9K00A0035.txt"
                    }
                ],
                "drone_sn": "1581F6QAD238F0010244",
                "landing_dock_sn": "",
                "in_flight_uuids": null,
                "wayline_uuids": null,
                "in_flight_infos": null,
                "track_information": {
                    "ext": null,
                    "wayline_name": "",
                    "drone_info": {
                        "device_name": "",
                        "device_model": "",
                        "device_type": "",
                        "device_sn": ""
                    }
                },
                "ext": [
                    {
                        "delete_at": 0,
                        "err_code": 0,
                        "ext": {
                            "action_type": 0,
                            "distance": 0,
                            "drone_model_key": "",
                            "duration": 0,
                            "end_altitude": 0,
                            "end_latitude": 0,
                            "end_longitude": 0,
                            "estimated_photo_count": 0,
                            "exit_on_rc_lost_behavior": 0,
                            "exit_on_rc_lost_type": 0,
                            "fingerprint": "",
                            "has_collisions": false,
                            "library_type": "",
                            "obstacles": null,
                            "payload_model_key": null,
                            "smart_oblique_on": false,
                            "start_altitude": 0,
                            "start_latitude": 0,
                            "start_longitude": 0,
                            "survey_scope": {
                                "points": null
                            },
                            "surveyed_area": 0,
                            "template_types": null,
                            "wayline_point_nums": 0,
                            "with_megaphone": false,
                            "with_search_light": false
                        },
                        "finger_print": "",
                        "id": "",
                        "is_origin": true,
                        "is_wayline_validity_check": false,
                        "name": "",
                        "suffix": "",
                        "updated_at": 0,
                        "url": "",
                        "user_name": "",
                        "wayline_name": "",
                        "wayline_validity_check_codes": null
                    }
                ],
                "wayline_name": "",
                "drone_info": {
                    "device_name": "M3D",
                    "device_model": "0-91-0",
                    "device_type": "91",
                    "device_sn": "1581F6QAD238F0010244"
                }
            }
        ],
        "flight_task_id": "0543388c-1ed9-4915-beac-4d8b47fa16ef",
        "related_users": [
            {
                "user_name": "deshawn.song",
                "user_id": "1564883503387430912",
                "oper_type": ""
            }
        ],
        "task_type": 2,
        "flight_task_type": 2,
        "folder_id": 713048
    }
}
🟠401
🟠404
🔴500
Modified at 2026-05-26 14:32:15
Previous
Get Flight Task Track Information
Next
Get Flight Task Information
Built with