Copies a task
Creates a new task by copying a source task (template_id) into a target project, task list, and workflow status. By default only the task shell is copied; enable the copy_* flags to duplicate its details.
Required: title, template_id (the source task), project_id, task_list_id, workflow_status_id, and private.
Set parent_task_id to copy the source as a subtask under another task. Set copy_as_task_template: true together with template_description to save the result as a reusable task template.
All copy_* flags default to false. Each flag is evaluated independently — the source task is always copied; the flags control which related data follows.
| Flag(s) | Prerequisite | Notes |
|---|---|---|
copy_open_subtasks, copy_closed_subtasks |
— | Recursive — subtask copying respects the same copy_* flags |
copy_open_todos, copy_closed_todos |
— | — |
copy_comments, copy_description, copy_attachments, copy_subscribers |
— | — |
copy_assignee, copy_tags, copy_date, copy_repeat, copy_estimate |
— | — |
copy_task_dependencies |
— | Blocking, waiting-on, and linked |
copy_custom_fields |
— | Task custom field values |
copy_as_task_template |
— | Registers the result as a reusable task template |
private: true rejects copy_open_subtasks, copy_closed_subtasks, and copy_as_task_template (422 task_private_not_allowed). copy_as_task_template: true rejects copy_task_dependencies (422 task_dependencies_not_allowed_on_template).
{
"data": {
"type": "tasks",
"attributes": {
"title": "New empty task from source",
"template_id": 5560123,
"project_id": 31002,
"task_list_id": 7781,
"workflow_status_id": 101,
"private": false
}
}
}
{
"data": {
"type": "tasks",
"attributes": {
"title": "Onboarding checklist — Acme",
"template_id": 5560123,
"project_id": 31002,
"task_list_id": 7781,
"workflow_status_id": 101,
"private": false,
"copy_assignee": true,
"copy_date": true,
"copy_repeat": true,
"copy_estimate": true,
"copy_description": true,
"copy_tags": true,
"copy_subscribers": true,
"copy_attachments": true,
"copy_comments": true,
"copy_custom_fields": true,
"copy_open_todos": true,
"copy_open_subtasks": true,
"copy_task_dependencies": true
}
}
}