/api/v2/projects/copy

POST
Projects • Projects

Copies a project

Description

Creates a new project by copying an existing source project. Use copy_as_template: true to mark the result as a project template.

Copy flags

All copy_* flags default to false. A flag with a prerequisite requires the listed parent flag(s) to also be enabled.

Flag(s) Prerequisite Notes
copy_boards Required by copy_task_lists
copy_task_lists copy_boards Required by copy_open_tasks, copy_closed_tasks
copy_open_tasks, copy_closed_tasks copy_task_lists Required by per-task flags below
copy_memberships Required by copy_assignees, copy_task_subscribers
copy_assignees, copy_task_subscribers copy_open_tasks or copy_closed_tasks + copy_memberships
copy_task_comments, copy_task_attachments, copy_task_description, copy_tags, copy_due_date, copy_start_date, copy_repeat, copy_estimate copy_open_tasks or copy_closed_tasks
copy_task_open_todos, copy_task_closed_todos, copy_task_open_subtasks, copy_task_closed_subtasks, copy_task_dependencies, copy_task_templates copy_open_tasks or copy_closed_tasks
copy_views, copy_custom_fields, copy_notes, copy_dashboards, copy_surveys, copy_budgets Independent
copy_deals Forced to false for internal project types
copy_as_template Marks the result as a template (creates a linked Template record)

Save Project as Template (Productive web app defaults)

The "Save as Template" UI sends copy_as_template: true.

{
  "data": {
    "type": "projects",
    "attributes": {
      "name": "Q4 marketing campaign template",
      "template_id": 123456,
      "project_type_id": 2,
      "project_manager_id": 42,
      "project_color_id": 5,
      "company_id": 999,
      "copy_as_template": true,
      "copy_memberships": true, // sharing
      "copy_boards": true, // folders
      "copy_views": true,
      "copy_custom_fields": true,
      "copy_dashboards": true,
      "copy_task_lists": true,
      "copy_open_tasks": true,
      "copy_closed_tasks": false,
      "copy_task_comments": true,
      "copy_task_subscribers": true,
      "copy_task_attachments": true,
      "copy_task_open_todos": true,
      "copy_task_closed_todos": false,
      "copy_task_open_subtasks": true,
      "copy_task_closed_subtasks": false,
      "copy_task_dependencies": true,
      "copy_task_description": true,
      "copy_assignees": true,
      "copy_tags": true,
      "copy_due_date": true,
      "copy_start_date": true,
      "copy_repeat": true,
      "copy_estimate": true,
      "copy_notes": true, // docs
      "copy_surveys": true, // forms
      "copy_task_templates": true
    }
  }
}

Plain project copy

Duplicate an existing project as a new working project.

{
  "data": {
    "type": "projects",
    "attributes": {
      "name": "Q4 marketing campaign — Acme",
      "template_id": 123456,
      "project_type_id": 2,
      "company_id": 999,
      "copy_boards": true,
      "copy_task_lists": true,
      "copy_open_tasks": true,
      "copy_task_comments": true,
      "copy_task_attachments": true,
      "copy_task_description": true,
      "copy_due_date": true,
      "copy_start_date": true,
      "copy_estimate": true,
      "copy_memberships": true,
      "copy_assignees": true,
      "copy_custom_fields": true,
      "copy_views": true,
      "copy_dashboards": true
    }
  }
}

Minimal copy (structure only)

Only the required attributes. All copy_* flags default to false — you get a new empty project with the source's metadata.

{
  "data": {
    "type": "projects",
    "attributes": {
      "name": "New empty internal project from source",
      "template_id": 123456,
      "project_type_id": 1
    }
  }
}
Loading parameters…
Loading request bodies…
Loading responses…