Reorder task custom fields

Updates the display order of task custom fields.

How it works: Provide an array of custom field 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 ["field-3", "field-1", "field-2"], the fields will be displayed in that order in task forms.

Note: The order affects how fields appear in task creation and editing forms.

POST/administration/task-settings/custom-fields/sort

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Request body

requiredapplication/json

idsstring[]required

Array of custom field IDs in the desired order

Responses

200Task custom fields reordered successfully

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X POST "https://leadtime.app/api/public/administration/task-settings/custom-fields/sort" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "123e4567-e89b-12d3-a456-426614174000",
    "987fcdeb-51a2-43d7-b456-426614174000"
  ]
}'

const response = await fetch("https://leadtime.app/api/public/administration/task-settings/custom-fields/sort", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "ids": [
    "123e4567-e89b-12d3-a456-426614174000",
    "987fcdeb-51a2-43d7-b456-426614174000"
  ]
})
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/administration/task-settings/custom-fields/sort",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "ids": [
    "123e4567-e89b-12d3-a456-426614174000",
    "987fcdeb-51a2-43d7-b456-426614174000"
  ]
},
)

Response

Task custom fields reordered successfully