Reorder tasks within a group (task type)

What this endpoint does: Reorders tasks within a specific task type group (row) in the Big Picture view. Tasks are arranged from left to right, where tasks further to the left have higher priority than those to the right. This is equivalent to dragging and dropping tasks within a row in the visual interface.

How it works:

• Provide the project ID and the group ID (task type ID) you want to reorder
• Provide an array of task IDs in the desired new order (left to right = highest to lowest priority)
• The order array must include all tasks currently in that group - you cannot omit tasks
• Tasks are reordered within their group only; this does not move tasks between groups or change task types

Visual behavior: After reordering, tasks will appear in the Big Picture view in the new sequence. The leftmost task becomes the highest priority item for that task type, making it easy to see what should be worked on first.

Use cases:

• Prioritizing tasks within a category (e.g., which features are most important to customers)
• Adjusting task order based on customer feedback during meetings
• Reorganizing tasks after planning discussions or sprint planning
• Setting up task sequence for team members to follow
• Responding to urgent requests by moving critical tasks to the left

Validation:

• Project must exist and not be deleted
• Group ID must be a valid task type ID for the project
• Order array must contain valid task IDs that belong to the specified group
• All tasks currently in the group must be included in the order array (no tasks can be omitted)

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

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

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

import requests

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

{
  "success": true
}