---
title: "Update Flight Task Status"
method: PUT
path: "/openapi/v2.0/flight-task/{task_uuid}/status"
tags: ["Flight Task/Task Update", "Flight Task"]
---

# Update Flight Task Status

`PUT /openapi/v2.0/flight-task/{task_uuid}/status`

## Request

- Base URL: `` (relative, and it does not resolve against the document’s source URL)
- URL: `/openapi/v2.0/flight-task/{task_uuid}/status`
- Auth: none required

Supports flight task status updates; only single timed, recurring, and continuous task types are supported

## Path parameters

- `task_uuid` string, required

## Headers

- `X-User-Token` string, required
- `X-Project-Uuid` string, required
- `X-Request-Id` string, uuid
- `X-Language` 'zh' | 'en'

## Request body

- object
  - `status` 'suspended' | 'restored', required: Task status; only supports status updates before task execution. Once a task is suspended, it will no longer be dispatched to the dock for execution

## Response `200`

Success

- object
  - `code` integer: Non-zero Indicates Exception
  - `message` string: Message Prompt

## Other responses

- `401`: Login expired, please log in again
- `404`: Flight Task Not Found
- `422`: Invalid status update. The status field supports only suspended (suspend a pending task) and restored (resume a suspended task). A task can be suspended only when in waiting state, and can be resumed only when in suspended state
- `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)