# 设置任务优先级 (/zh-CN/api-reference/api-ref/ppt-conversion-service/set-task-priority)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

将待进行的指定任务移动至任务队列最前面或最后面。

- OpenAPI: /openapi/ppt-conversion-service/rest-api.zh-CN.yaml
- Operation ID: put-v5-projector-tasks-uuid-priority
- Method: PUT
- Path: /v5/projector/tasks/{uuid}/priority
- Endpoint: https://api.netless.link/v5/projector/tasks/{uuid}/priority

## Servers

- https://api.netless.link

## Parameters

- `token` (header, required, string) - SDK Token，可以通过以下方式获取：

- 在声网控制台生成用于测试的 SDK Token，详见[获取安全密钥](/zh-CN/realtime-media/ppt-transcoding/build/setup-and-access/enable-service#2-获取安全密钥)。
- 调用服务端 RESTful API， 详见[生成 SDK Token](generate-sdk-token)。
- 在 app 服务端用代码生成，详见[在 app 服务端生成 Token](/zh-CN/realtime-media/whiteboard/fastboard-sdk/build/setup-and-access/generate-token#在-app-服务端生成-token)。
- `region` (header, required, string) - 指定处理该请求的数据中心，取值如下：

- `cn-hz`：中国杭州，服务区覆盖中国大陆地区及其他数据中心未覆盖的区域。
- `us-sv`：美国硅谷，服务区覆盖北美洲、南美洲。
- `sg`：新加坡，服务区覆盖新加坡、东亚、东南亚。
- `in-mum`：印度孟买，服务区覆盖印度。
- `eu`：欧洲（法兰克福），服务区覆盖欧洲。
  - Allowed: `cn-hz` | `us-sv` | `sg` | `in-mum` | `eu`
- `uuid` (path, required, string) - 转换任务的 UUID，即转换任务的唯一标识符，可通过调用[发起 PPT 转码 API](start-conversion) 获取。

## Request body

- `priority` (string, required) - 设定优先级，取值如下：

- `highest`：最高，即移动至任务队列最前。
- `lowest`：最低，即移动至任务队列末尾。

## Responses

### 200

若返回的状态码为 `200` 则表示请求成功。响应包体中包含本次请求的结果。

若返回的状态码不为 `200` 则表示请求失败。你可以参考[响应状态码](/zh-CN/realtime-media/ppt-transcoding/reference/response-code)了解可能的原因。

- `uuid` (string) - 转换任务的 UUID，即转换任务的唯一标识符。
- `success` (boolean) - 是否成功设置优先级：

- `true`：设置成功。
- `false`：设置失败。

## Response examples

### 200

```json
{
  "uuid": "2fd2dxxxxx367e\"",
  "success": true
}
```