/api/v2/folders/copy

Creates a new folder by copying a source folder (template_id) into a target project. By default only the folder shell is copied; enable the copy_* flags to duplicate its task lists, tasks, and their details.

Required: name, template_id (the source folder), and project_id.

Copy flags

Copying cascades through levels: enable copy_task_lists to bring over the folder's task lists, then copy_open_tasks / copy_closed_tasks to bring over their tasks, then the per-task flags to bring over task details. All copy_* flags default to false.

Enabling tasks without copy_task_lists returns 422 (task_lists_required); enabling any per-task flag without a tasks gate returns 422 (tasks_required).

Minimal copy (shell only)

{
  "data": {
    "type": "folders",
    "attributes": {
      "name": "Design (copy)",
      "template_id": 88440,
      "project_id": 31002
    }
  }
}

Full copy with task lists and tasks

{
  "data": {
    "type": "folders",
    "attributes": {
      "name": "Design (copy)",
      "template_id": 88440,
      "project_id": 31002,
      "copy_task_lists": true,
      "copy_open_tasks": true,
      "copy_task_comments": true,
      "copy_task_description": true,
      "copy_task_subscribers": true,
      "copy_task_attachments": true,
      "copy_task_open_todos": true,
      "copy_task_open_subtasks": true,
      "copy_task_dependencies": true,
      "copy_assignees": true,
      "copy_tags": true,
      "copy_due_date": true,
      "copy_start_date": true,
      "copy_repeat": true,
      "copy_estimate": true,
      "copy_custom_fields": true
    }
  }
}