Update project order within a pool
Updates the vertical order of projects within a pool for a specific accountable user. Projects are displayed as rows in the pool view, and this endpoint allows you to customize which projects 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 PoolProjectOrder table, which stores the custom sort order for projects within each accountable user’s pool. The order determines how projects are displayed vertically in the pool view.
The newOrder array should contain all project IDs that need to be reordered, in the desired sequence (first item = topmost position).
Permission requirements:
- Pool.canEditAll: Can edit any user’s pool project order
- Pool.canEditOwnTeams: Can edit pools of users in the same team (requires team membership verification)
- Pool.canEditOwn: Can only edit your own pool project order (accountableId must match authenticated user.id)
The accountableId must reference a valid user in the same workspace who is not deleted.
/tasks/pool/project-orderAuthorizationOAuth2 access token · headerrequiredapi:writeAuthorizationBearer token (JWT) · headerrequiredapplication/jsonaccountableIdstringrequirednewOrderstring[]requiredsuccessbooleancurl -X POST "https://leadtime.app/api/public/tasks/pool/project-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"
]
}'const response = await fetch("https://leadtime.app/api/public/tasks/pool/project-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"
]
})
});import requests
response = requests.post(
"https://leadtime.app/api/public/tasks/pool/project-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"
]
},
){
"success": true
}