Reorder questions within a library component item

Reorders questions within a component library item by providing a new sort order array of question IDs.

What are Questions? Questions capture customer-specific requirements or project details. They are attached to component items and displayed in the order specified by their sort field.

All question IDs in the newSortOrder array must belong to the specified item. Only library component items (component.projectId is null) are accessible through this endpoint.

POST/administration/project-components/item-details/{itemId}/questions/sort

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

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 in the desired display order.

Responses

200

Questions 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

Parameters

itemIdpath*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/administration/project-components/item-details/3047983b-d798-4aff-8dd4-628cf1900703/questions/sort" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "newSortOrder": [
    "e57dc37b-7693-4d06-b49c-17084b773aff",
    "f68ed48c-8704-5e17-c5ad-28195c884b00"
  ]
}'

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

import requests

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

Response

{
  "success": true
}