Duplicate a tagged report

View as Markdown
This endpoint lets you duplicate a tagged report, creating a new report from the tagged version. The report copy can be placed in a different folder from the original report, potentially with a different name and description. This is useful for creating report templates or backups. ### Usage notes - The reportId and version tag in the URL specify the tagged version of the report to duplicate. Retrieve the **reportId** by calling the [/v2/reports](https://help.sigmacomputing.com/reference/list-reports) endpoint. For the **versionTag**, you can specify either the tag name or ID. Retrieve the version tag name or ID by calling the [/v2/tags](https://help.sigmacomputing.com/reference/list-version-tag) 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`. ### Best practices - Always verify that the destination folder has the correct permissions set to avoid access issues.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

reportIdstringRequired
versionTagstringRequired

Request

The request body.
destinationFolderIdstringRequired
ID of the folder in which to place the copied report.
namestringRequired
Name for the copied report as it appears in Sigma.
descriptionstringOptional
A description for the new report.

Response

The response body.
reportIdstring
Unique identifier of the report.
reportUrlIdstring
namestring
urlstring
pathstring
latestVersiondouble
ownerIdstring
createdBystring
The identifier of the user who created this object.
updatedBystring
The identifier of the user or process that last updated this object.
createdAtdatetime
When the object was created.
updatedAtdatetime
When the object was last updated.
isArchivedboolean
tagslist of objects
descriptionstring