Reorder questions within a component item

Reorders questions within a component item by providing a new sort order array of question IDs. The sort order determines the display order of questions in the UI and affects condition evaluation order. All questions for the item must be included in the newSortOrder array.

POST/projects/{projectId}/items/{itemId}/questions/sort

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

projectIdstringrequired

Project UUID

itemIdstringrequired

Component item UUID. Items are the building blocks within components (Epics, Work Packages, Todo Lists, Test Suites).

Request body

requiredapplication/json

newSortOrderstring[]required

Array of question IDs in new order. All questions for the item must be included.

Responses

200

Questions reordered successfully

successboolean

400

Invalid UUID format or failed to sort questions

401

Unauthorized - Invalid or missing authentication token

403

Insufficient permissions to manage components or access to project denied

404

Item not found or does not belong to a component in the project, or question IDs not found in the item

422

Incomplete sort order: not all questions for the item are included in newSortOrder

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

projectIdpath*Project UUIDitemIdpath*Component item UUID. Items are the building blocks within components (Epics, Work Packages, Todo Lists, Test Suites).

Bodyapplication/json

Request body

Request

curl -X POST "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/3047983b-d798-4aff-8dd4-628cf1900703/questions/sort" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "newSortOrder": [
    "f68ed48c-8704-5e17-c5ad-28195c884b00",
    "a47dc37b-7693-4d06-b49c-17084b773aff"
  ]
}'

const response = await fetch("https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/3047983b-d798-4aff-8dd4-628cf1900703/questions/sort", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"newSortOrder\": [\n    \"f68ed48c-8704-5e17-c5ad-28195c884b00\",\n    \"a47dc37b-7693-4d06-b49c-17084b773aff\"\n  ]\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/3047983b-d798-4aff-8dd4-628cf1900703/questions/sort",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"newSortOrder\": [\n    \"f68ed48c-8704-5e17-c5ad-28195c884b00\",\n    \"a47dc37b-7693-4d06-b49c-17084b773aff\"\n  ]\n}",
)

Response

{
  "success": true
}