---
title: "Duplicate a report"
method: POST
path: "/v2/reports/{reportId}/copy"
tags: ["Reports"]
---

# Duplicate a report

`POST /v2/reports/{reportId}/copy`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/reports/{reportId}/copy`
- Auth: HTTP bearer

This endpoint lets you duplicate an existing report. The report copy can be placed in a different folder from the original report, potentially with a different name and description.

### Usage notes
- The `reportId` parameter specifies the original report to be copied. Retrieve the **reportId** by calling the [/v2/reports](https://help.sigmacomputing.com/reference/list-reports) endpoint.
- The `destinationFolderId` in the request body specifies where to place the new report.
  - To use the "My Documents" folder for a specific user as the destination folder, call the [/v2/members/{memberId}](https://help.sigmacomputing.com/reference/get-member) endpoint and use the `homeFolderId` included in the response.
  - Retrieve the **folderId** of all folders by calling the [/v2/files](https://help.sigmacomputing.com/reference/list-files) endpoint and reviewing the `id` field in the response for files with a `type` of `folder`.

### Usage scenarios
- **Reuse report structure**: Use an existing report as a baseline to make changes to.
- **Backup**: Make a backup of a report before making significant changes.

### Best practices
- Always verify that the destination folder has the correct permissions set to avoid access issues.

## Path parameters

- `reportId` string, required

## Request body

- object
  - `destinationFolderId` string, required: ID of the folder in which to place the copied report.
  - `name` string, required: Name for the copied report as it appears in Sigma.
  - `description` string: A description for the new report.

## Response `200`

The response body.

- ReportsCopyReportResponse200
  - `reportId` string, required: Unique identifier of the report.
  - `reportUrlId` string, required
  - `name` string, required
  - `url` string, required
  - `path` string, required
  - `latestVersion` number, double, required: The most recently published document version of the report.
  - `ownerId` string, required
  - `createdBy` string, required: The identifier of the user who created this object.
  - `updatedBy` string, required: The identifier of the user or process that last updated this object.
  - `createdAt` string, date-time, required: When the object was created.
  - `updatedAt` string, date-time, required: When the object was last updated.
  - `isArchived` boolean
  - `tags` V2ReportsReportIdCopyPostResponsesContentApplicationJsonSchemaTagsItems[]
    - `versionTagId` string, required: Unique identifier of the tag.
    - `tagName` string, required
    - `sourceVersion` number, double, required
    - `taggedAt` string, date-time, required
    - `taggedReportId` string, required: Unique identifier of the tagged report.
  - `description` string

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)