Reorder task type groups (rows)

What this endpoint does: Reorders the task type groups (rows) themselves in the Big Picture view. This changes which task types appear first, second, third, etc., from top to bottom in the visual display. This is equivalent to dragging and dropping entire rows in the visual interface.

How it works:

• Provide the project ID
• Provide an array of group IDs (task type IDs) in the desired new order (top to bottom)
• The order array must include all groups currently in the project - you cannot omit groups
• This reorders entire rows, not individual tasks within rows
• The first group ID in the array will appear at the top, the last at the bottom

Visual behavior: After reordering, task type rows will appear in the Big Picture view in the new sequence. This affects the visual hierarchy - task types at the top are more prominent and appear first when viewing the project.

Use cases:

• Prioritizing which task types are most important (e.g., Bugs before Features, urgent categories first)
• Organizing the view to match team workflow and working habits
• Customizing the Big Picture layout for different project contexts or customer preferences
• Improving visual hierarchy for project stakeholders - show most relevant categories first
• Grouping related task types together for better overview

Special groups:

• Tasks without a recognized type are grouped into a special “other” category
• The “other” group can be included in the order array like any other group

Validation:

• Project must exist and not be deleted
• Order array must contain valid group IDs (task type IDs) that exist in the project
• All groups currently in the project must be included in the order array (no groups can be omitted)

Permissions: Requires BigPicture.canEdit permission and access to the specified project.

curl -X POST "https://leadtime.app/api/public/tasks/bigPicture/group-order" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "newOrder": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b1c2d3e4-f5a6-7890-abcd-ef1234567890",
    "c1d2e3f4-a5b6-7890-abcd-ef1234567890"
  ],
  "projectId": "7225cca9-ac5f-461d-9a9d-ad8d7ee1b597"
}'

const response = await fetch("https://leadtime.app/api/public/tasks/bigPicture/group-order", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "newOrder": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b1c2d3e4-f5a6-7890-abcd-ef1234567890",
    "c1d2e3f4-a5b6-7890-abcd-ef1234567890"
  ],
  "projectId": "7225cca9-ac5f-461d-9a9d-ad8d7ee1b597"
})
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/tasks/bigPicture/group-order",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "newOrder": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b1c2d3e4-f5a6-7890-abcd-ef1234567890",
    "c1d2e3f4-a5b6-7890-abcd-ef1234567890"
  ],
  "projectId": "7225cca9-ac5f-461d-9a9d-ad8d7ee1b597"
},
)

{
  "success": true
}