Copies a task list
Creates a new task list by copying a source task list (template_id) into a target project and folder. By default only the task list shell is copied; enable the copy_* flags to duplicate its tasks and their details.
Required: name, template_id (the source task list), project_id, and the target folder_id.
All copy_* flags default to false. Every flag below requires the "tasks" gate — at least one of copy_open_tasks / copy_closed_tasks.
| Flag(s) | Prerequisite | Notes |
|---|---|---|
copy_open_tasks, copy_closed_tasks |
— | The "tasks" gate |
copy_task_comments, copy_task_description, copy_task_subscribers, copy_task_attachments |
copy_open_tasks or copy_closed_tasks |
— |
copy_task_open_todos, copy_task_closed_todos |
copy_open_tasks or copy_closed_tasks |
— |
copy_task_open_subtasks, copy_task_closed_subtasks |
copy_open_tasks or copy_closed_tasks |
— |
copy_task_dependencies |
copy_open_tasks or copy_closed_tasks |
— |
copy_assignees, copy_tags, copy_due_date, copy_start_date, copy_repeat, copy_estimate |
copy_open_tasks or copy_closed_tasks |
— |
copy_custom_fields |
copy_open_tasks or copy_closed_tasks |
Task custom field values |
Enabling any dependent flag without a tasks gate returns 422 (tasks_required).
{
"data": {
"type": "task_lists",
"attributes": {
"name": "Sprint 5",
"template_id": 884412,
"project_id": 31002,
"folder_id": 7781
}
}
}
{
"data": {
"type": "task_lists",
"attributes": {
"name": "Sprint 5 (copy)",
"template_id": 884412,
"project_id": 31002,
"folder_id": 7781,
"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
}
}
}