/api/v2/tasks/{id}/move_dependent

PATCH
Tasks • Tasks

Moves a task and its dependent tasks by a given number of working days

Description

Shifts a task and all of its blocking-dependent tasks forward or backward by a number of working days. Useful for re-baselining a Gantt schedule when an upstream task slips.

Pass days_count as a signed integer — positive shifts forward, negative shifts backward. The shift counts only working days (weekends and configured non-working days from the organization's working hours are skipped). Closed tasks, tasks without a due_date, and tasks the caller cannot access are silently excluded from the move.

The dependent graph is walked recursively via blocking dependencies (task_dependency rows of type blocking).

Set skip_root_task: true to shift only the dependents and leave the root task in place — useful when only downstream work needs to slide. Defaults to false.

Each moved task gets a Gantt - Move dependent tasks activity entry for auditability.

Returns 422 if shifting the dates would conflict with existing time bookings on any of the moved tasks (booking constraints are validated up-front, no partial moves are persisted).

{
  "data": {
    "type": "tasks",
    "attributes": {
      "days_count": 5,
      "skip_root_task": false
    }
  }
}
Loading parameters…
Loading request bodies…
Loading responses…