---
title: "Copies a task list"
method: POST
path: "/api/v2/task_lists/copy"
tags: ["Task Lists"]
---

# Copies a task list

`POST /api/v2/task_lists/copy`

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`.

### Copy flags

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`).

### Minimal copy (shell only)
```json
{
  "data": {
    "type": "task_lists",
    "attributes": {
      "name": "Sprint 5",
      "template_id": 884412,
      "project_id": 31002,
      "folder_id": 7781
    }
  }
}
```

### Full copy with tasks
```json
{
  "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
    }
  }
}
```

## Headers

- `X-Organization-Id` string, required

## Response `201`

Single task list

## Other responses

- `422` — Returned when the copy request body fails validation.

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/versions/6bb0150a5c5f/schema)