Reorder project custom fields

Updates the display order of project custom fields by providing an ordered array of field IDs.

How it works:

Provide an array of custom field IDs in the desired display order
The first ID in the array will have sort order 0, second will have 1, etc.
Fields not included in the array will maintain their current sort order

Example: If you provide [“field-3”, “field-1”, “field-2”], then:

field-3 will appear first in project forms
field-1 will appear second
field-2 will appear third

Note: This affects the order in which custom fields appear in project creation and editing forms.

POST/administration/project-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

200

Project custom fields reordered successfully

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/project-settings/custom-fields/sort" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "field-1",
    "field-2",
    "field-3"
  ]
}'

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

import requests

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

Response

Project custom fields reordered successfully