Sort test cases within a component item

Reorders test cases within a component item by providing a new sort order array. The sort order determines the display order of test cases in the UI and affects condition evaluation order. All test case IDs in the array must belong to the specified item.

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

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

projectIdstringrequired

Project UUID

itemIdstringrequired

Component item UUID

Request body

requiredapplication/json

newSortOrderstring[]required

Array of test case IDs in desired order

Responses

200

Test cases successfully sorted

successboolean

400

Invalid projectId, itemId, or test case IDs format

401

Unauthorized - Invalid or missing authentication token

403

Insufficient permissions or no access to project

404

Project or item not found, or item does not belong to the project

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

Bodyapplication/json

Request body

Request

curl -X POST "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/e57dc37b-7693-4d06-b49c-17084b773aff/testcases/sort" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "newSortOrder": [
    "e57dc37b-7693-4d06-b49c-17084b773aff",
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  ]
}'

const response = await fetch("https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/e57dc37b-7693-4d06-b49c-17084b773aff/testcases/sort", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"newSortOrder\": [\n    \"e57dc37b-7693-4d06-b49c-17084b773aff\",\n    \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n  ]\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/e57dc37b-7693-4d06-b49c-17084b773aff/testcases/sort",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"newSortOrder\": [\n    \"e57dc37b-7693-4d06-b49c-17084b773aff\",\n    \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n  ]\n}",
)

Response

{
  "success": true
}