# Set a task's priority

> Sets or clears a task's priority. PUT /api/v1/tasks/{task_id}/priority in the SOAT REST API.

Sets or clears a task's priority. An action of its own, `tasks:SetTaskPriority`, so a principal can update a task without reprioritising it; create-task and update-task do not accept `priority`.

  Request

<ParamsDetails
  {...require("./set-task-priority.ParamsDetails.json")}
>

<RequestSchema
  {...require("./set-task-priority.RequestSchema.json")}
>

<StatusCodes
  {...require("./set-task-priority.StatusCodes.json")}
>
