---
title: "Control Wayline Task (Pause / Resume / Cancel)"
method: PUT
path: "/openapi/v2.0/drc/api/v2/projects/{uuid}/flight-wayline-tasks/commands"
tags: ["Real-time Control/Flight Control Commands/Airborne Task"]
---

# Control Wayline Task (Pause / Resume / Cancel)

`PUT /openapi/v2.0/drc/api/v2/projects/{uuid}/flight-wayline-tasks/commands`

## Request

- Base URL: `https://41b04hdzmc.apifox.cn` (the document declares no server; this is the origin it was published from)
- URL: `https://41b04hdzmc.apifox.cn/openapi/v2.0/drc/api/v2/projects/{uuid}/flight-wayline-tasks/commands`
- Auth: none required

Dispatch real-time control command to executing wayline task; makes aircraft hover in current position, resume from paused position, or cancel task and return home. Commonly used in scenarios like pilot temporary intervention, sudden situation avoidance, early task termination.

## Path parameters

- `uuid` string, required

## Headers

- `x-user-token` string, required
- `X-Request-Id` string, uuid
- `X-Project-Uuid` string, required

## Request body

- object
  - `drone_sn` string, required: Target Aircraft SN
  - `action` 'pause' | 'resume' | 'cancel', required: Control Command: pause=Pause (aircraft hovers in current position; retains task progress) / resume=Resume (resumes wayline execution from paused position) / cancel=Cancel (terminates current wayline task)

## Response `200`

Operation Successful

- object
  - `code` integer, required: Business Status Code: 0=Success; non-zero=Error Code (see message for meaning)
  - `message` string: Error Description Message (Omitted on Success)
  - `data` object: This API Has No Business Return Data

## Other responses

- `400`: Business Parameter Error — body contains code (non-zero)/message
- `500`: Internal Service Error

---

[API](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-on-premises.md) - [All operations](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-on-premises/llms.txt) - [OpenAPI document](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-on-premises/revisions/e4544b7809ea?raw)