Update group/type order within a project in a pool

Updates the horizontal order of task type groups (e.g., Feature, Bug, Task) within a specific project in a pool for a specific accountable user. Groups are displayed as columns within each project row, and this endpoint allows you to customize which task types appear first.

Important: The pool contains tasks filtered by the Accountable field (not the Assigned field). Only tasks where the accountableId user is set as the Accountable person are included in the pool.

This endpoint updates the PoolTypeProjectOrder table, which stores the custom sort order for task type groups within each project for each accountable user. The order determines how task types are displayed horizontally within each project row in the pool view.

The newOrder array should contain all task type IDs that need to be reordered, in the desired sequence (first item = leftmost position).

Permission requirements:

Pool.canEditAll: Can edit any user’s pool group order
Pool.canEditOwnTeams: Can edit pools of users in the same team (requires team membership verification)
Pool.canEditOwn: Can only edit your own pool group order (accountableId must match authenticated user.id)

The accountableId must reference a valid user in the same workspace who is not deleted. The projectId must reference a valid project in the same workspace.

POST/tasks/pool/group-order

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Request body

requiredapplication/json

accountableIdstringrequired

UUID of the accountable user whose pool group order should be updated. The user must exist in the same workspace and not be deleted. Access is controlled by Pool edit permissions (canEditAll, canEditOwnTeams, or canEditOwn).

newOrderstring[]required

Array of task type UUIDs in the desired horizontal order. Task type groups are displayed as columns within the project row, with the first item in the array appearing on the left. The array should contain all task type IDs that need to be reordered. Each task type ID must be a valid UUID of a task type configured in the workspace.

projectIdstringrequired

UUID of the project within which the task type group order should be updated. The project must exist in the same workspace. Task type groups (e.g., Feature, Bug, Task) are displayed as columns within each project row in the pool view.

Responses

200Successfully updated group order

successboolean

400Invalid accountableId or projectId UUID format or invalid newOrder array

401Unauthorized - Invalid or missing authentication token

403User lacks required Pool edit permissions

404User (accountableId) not found, deleted, or not in same workspace

Request

curl -X POST "https://leadtime.app/api/public/tasks/pool/group-order" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "accountableId": "aff55c87-49c6-4d5d-9b0b-bf7478e2d504",
  "newOrder": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "6ba7b811-9dad-11d1-80b4-00c04fd430c8"
  ],
  "projectId": "550e8400-e29b-41d4-a716-446655440000"
}'

const response = await fetch("https://leadtime.app/api/public/tasks/pool/group-order", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "accountableId": "aff55c87-49c6-4d5d-9b0b-bf7478e2d504",
  "newOrder": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "6ba7b811-9dad-11d1-80b4-00c04fd430c8"
  ],
  "projectId": "550e8400-e29b-41d4-a716-446655440000"
})
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/tasks/pool/group-order",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "accountableId": "aff55c87-49c6-4d5d-9b0b-bf7478e2d504",
  "newOrder": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "6ba7b811-9dad-11d1-80b4-00c04fd430c8"
  ],
  "projectId": "550e8400-e29b-41d4-a716-446655440000"
},
)

Response

{
  "success": true
}