--- title: "Get Wayline Task Details" method: GET path: "/openapi/v2.0/flight-task/detail" tags: ["Flight Task/Task Query"] --- # Get Wayline Task Details `GET /openapi/v2.0/flight-task/detail` ## Request - Base URL: `` (relative, and it does not resolve against the document’s source URL) - URL: `/openapi/v2.0/flight-task/detail` - Auth: none required Query flight task details by flight_id (waypoints / name / template type, etc.) ## Query parameters - `workspace_id` string, uuid, required - `task_uuid` string, required ## Headers - `X-User-Token` string, required - `X-Project-Uuid` string, required - `X-Request-Id` string - `X-Language` string ## Response `200` Success - object - `code` integer: Business status code, 0 means success - `message` string: Business Message - `data` object: Wayline task details. Aggregates task-level timing and the details of each flight_piece (a single actual flight under the task) - `begin_at` string, date-time, nullable: Task planned start time (RFC3339, UTC) - `end_at` string, date-time, nullable: Task planned end time (RFC3339, UTC) - `create_at` string, date-time: Task created at (RFC3339, UTC) - `run_at` string, date-time, nullable: Task actual start execution time (RFC3339, UTC) - `completed_at` string, date-time, nullable: Task actual end or completion time (RFC3339, UTC) - `flight_task_id` string: Wayline Task UUID - `related_users` object[]: List of users related to this task (creator/executor/operator, etc.) - `user_name` string: User Name - `user_id` string: User ID - `oper_type` string: Operation type, distinguishes user's role in this task - `task_type` integer: Task type (task level). Downstream internal enum: 1=immediate task, 2=recurring task, 3=one-time scheduled task, 5=continuous task - `flight_task_type` integer: Flight task type (task level). Downstream internal enum: 1=automated, 2=manual - `folder_id` integer: Media folder ID, corresponding to the folder that this task's uploaded flight media belong to - `flight_pieces` object[]: Details of all flight_pieces (single actual flights) under this task. Each record embeds FlightTask (task metadata) and TrackInfo (track/UAV info), together with sub-structures such as exceptions, flight replays, and associated waylines - `ID` integer: Database Primary Key - `created_at` string, date-time: Created time of this flight_piece record - `begin_at` string, date-time, nullable: Planned Start Time of This Flight - `end_at` string, date-time, nullable: Planned End Time of This Flight - `run_at` string, date-time, nullable: Actual Start Execution Time of This Flight - `completed_at` string, date-time, nullable: Actual End or Completion Time of This Flight - `flight_task_id` string: Owning Wayline Task UUID - `flight_piece_id` string: Flight Piece UUID (unique) - `take_off_airport_sn` string: Takeoff Dock SN - `land_airport_sn` string: Landing Dock SN - `task_type` integer: Downstream original task type (integer enum), used together with the outer type field; for automatic tasks, mapped to immediate/timed/recurring/continuous/others - `type` 'immediate' | 'timed' | 'recurring' | 'continuous' | 'others' | 'manual': Exposed task type enum. For automatic tasks, mapped from task_type (1=immediate, 3=timed, 4=recurring, 5=continuous, others=others); always manual for manual tasks - `status` 'waiting' | 'starting_failure' | 'executing' | 'paused' | 'terminated' | 'success' | 'suspended' | 'timeout' | 'partially_done' | 'preparing' | 'queue_for_takeoff' | 'NA': Exposed task status enum, mapped from downstream task_status integer (0=waiting, 1=starting_failure, 2=executing, 3=paused, 4=terminated, 5=success, 6=suspended, 7=timeout, 8=partially_done, 9=preparing, 10=queue_for_takeoff) - `flight_task_type` integer: Downstream original flight task type integer enum: 1=automated, 2=manual. Used in conjunction with the outer task_flight_type string - `task_flight_type` 'automated' | 'manual': Exposed flight task type enum, mapped from flight_task_type: 1->automated, 2->manual - `task_flight_status` 'incomplete' | 'completed': Exposed flight overall status enum, mapped from downstream flight_task_status: 1->incomplete, 2->completed - `flight_task_status` integer: Downstream original flight overall status integer enum: 1=incomplete, 2=completed - `task_status` integer: Downstream original task status integer enum (0-10); see the status field mapping description - `task_name` string: Task Name - `user_id` string: Task Initiator User ID - `prj_uuid` string: Owning Project UUID - `wayline_uuid` string: Associated Wayline UUID (empty string when no association) - `cloud_to_cloud_id` string: Cloud-to-cloud integration bucket ID; empty means not a cloud-to-cloud task - `source` integer: Task source flag (0/1), omitempty: 0=default, 1=externally triggered - `workflow_uuid` string: Workflow UUID corresponding to the task; empty means non-workflow task - `exception` object, nullable: Exception info of this flight, null when no exception - `code` integer: Exception Error Code - `message` string: Exception Error Information - `happen_at` string, date-time, nullable: Exception Occurrence Time - `sn` string: Device SN That Triggered the Exception - `flight_records` object[]: Flight replay record list (FlightReplay) - `ID` integer: Database Primary Key - `CreatedAt` string, date-time: Record Created At - `flight_piece_id` string: Owning flight_piece UUID - `upload_sn` string: Device SN That Uploaded This Replay Data - `flight_record_path` string: Relative Path of Flight Replay File in Object Storage - `drone_sn` string: UAV SN Executing This Flight - `landing_dock_sn` string: Landing dock SN (different source from land_airport_sn; reported by the actual flight landing point) - `in_flight_uuids` string[], nullable: Wayline Flight Instance UUID List Dispatched in This Flight - `wayline_uuids` string[], nullable: Wayline UUID List Involved in This Flight - `in_flight_infos` object[], nullable: Detailed list of waypoint execution in this flight (InFlightWayLineInfo) - `id` integer: Database Primary Key - `flight_piece_id` string: Owning flight_piece UUID - `wayline_uuid` string: Associated Wayline UUID - `err_code` integer: Wayline execution error code (0 means no exception) - `total_way_points` integer: Wayline Total Waypoint Count - `way_point_index` integer: Current/Last Reached Waypoint Index - `in_flight_wayline_flight_id` string: Wayline Flight Instance ID Dispatched to Device - `status` integer: Wayline Dispatch Execution Status - `user_id` string: Dispatching User ID - `track_information` object: Aggregated track and UAV info (TrackInfo) - `ext` unknown - `wayline_name` string: Wayline Name - `drone_info` object: UAV Basic Info - `device_name` string: Device Name - `device_model` string: Device model key (e.g., 0-91-0) - `device_type` string: Device type field (DeviceModelEnum.Type) - `device_sn` string: Device SN - `ext` object[]: List of wayline extension info involved in this flight (from downstream task service, passed through) - `delete_at` integer: Deletion timestamp, 0 means not deleted - `err_code` integer: Wayline-Related Error Code - `ext` object: Wayline Metadata Extension - `action_type` integer: Action Type - `distance` number: Wayline Total Distance (meters) - `drone_model_key` string: UAV Model Key - `duration` number: Estimated Flight Duration (seconds) - `end_altitude` number: End Altitude (meters) - `end_latitude` number: End Latitude - `end_longitude` number: End Longitude - `estimated_photo_count` integer: Estimated Photo Count - `exit_on_rc_lost_behavior` integer: Behavior After Loss of Control - `exit_on_rc_lost_type` integer: Out-of-Control Type - `fingerprint` string: Wayline Fingerprint - `has_collisions` boolean: Whether Collision Detection Alert Exists - `library_type` string: Wayline Library Type - `obstacles` object[], nullable: Obstacle List - `payload_model_key` string[], nullable: Payload Model Key List - `smart_oblique_on` boolean: Whether Smart Tilt Is Enabled - `start_altitude` number: Start Altitude (meters) - `start_latitude` number: Start Latitude - `start_longitude` number: Start Longitude - `survey_scope` object: Survey Range - `points` object[], nullable: Range Polygon Point List - … - `surveyed_area` number: Survey Area - `template_types` string[], nullable: Wayline Template Type List - `wayline_point_nums` integer: Waypoint Count - `with_megaphone` boolean: Whether Equipped with Speaker - `with_search_light` boolean: Whether Equipped with Spotlight - `finger_print` string: Wayline fingerprint (synonymous with ext.fingerprint) - `id` string: Wayline ID - `is_origin` boolean: Whether It Is the Original Wayline - `is_wayline_validity_check` boolean: Whether Wayline Compliance Check Was Done - `name` string: Wayline Name - `suffix` string: Wayline File Suffix - `updated_at` integer: Updated Timestamp (seconds) - `url` string: Wayline File Download URL - `user_name` string: Wayline Creator Username - `wayline_name` string: Wayline Name - `wayline_validity_check_codes` integer[], nullable: Wayline Compliance Validation Error Code List - `wayline_name` string: Wayline name (from embedded TrackInfo, same source as track_information.wayline_name) - `drone_info` object: UAV basic info (from embedded TrackInfo, same source as track_information.drone_info) - `device_name` string - `device_model` string - `device_type` string - `device_sn` string ## Other responses - `401`: Login Expired - `404`: flight_id does not exist / wayline has been deleted - `500`: Server Internal Error --- [API](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud.md) - [All operations](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/revisions/aeef0010be34?raw)