move_task
Move a task to a new parent while preserving its uniqueID, dependencies, and resource assignments.
Instructions
Reparent a task without changing its uniqueID.
Wraps the omniJS task.move(newParent, index) method introduced in
OmniPlan 4.10.3 (build v232.5.9, 2026-05-06). Both omniJS args are
required at the API level; this tool fills in index with
newParent.subtasks.length (append at end) when the caller omits it.
Because uniqueID is preserved across the move, dependencies and resource assignments that reference the moved task stay intact — no clone-and-rebuild required.
Args:
task_id: uniqueID of the task to move.
new_parent_id: uniqueID of the destination parent. If omitted,
the task is moved to the document root.
index: 0-based position in new_parent.subtasks after the move.
If omitted, the task is appended at the end.
Returns:
JSON {moved: true, id, new_parent_id, index} where id is the
unchanged uniqueID, new_parent_id is the resolved parent's
uniqueID (root's -1 if moved to root), and index is the
final position used.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | ||
| new_parent_id | No | ||
| index | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |