Reorder task statuses

Updates the display order of task statuses.

How it works: Provide an array of task status IDs in the desired order. The first ID in the array will have sort order 1, the second will have sort order 2, and so on.

Example: If you provide ["status-new", "status-in-progress", "status-done"], the statuses will be displayed in that order in Kanban boards, dropdowns, and status lists.

Note: The order affects how statuses appear in task workflows and visual boards. Typically, you want statuses ordered to reflect the natural workflow progression.

POST/administration/task-settings/statuses/sort

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Request body

requiredapplication/json

idsstring[]required

Array of task status IDs in the desired order

Responses

200

Task statuses reordered successfully

successboolean

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Bodyapplication/json

Request body

Request

curl -X POST "https://leadtime.app/api/public/administration/task-settings/statuses/sort" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "status-1",
    "status-2",
    "status-3"
  ]
}'

const response = await fetch("https://leadtime.app/api/public/administration/task-settings/statuses/sort", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"ids\": [\n    \"status-1\",\n    \"status-2\",\n    \"status-3\"\n  ]\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/administration/task-settings/statuses/sort",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"ids\": [\n    \"status-1\",\n    \"status-2\",\n    \"status-3\"\n  ]\n}",
)

Response

{
  "success": true
}