Duplicate a tagged workbook
This endpoint lets you duplicate a tagged workbook, creating a new workbook from the tagged version. The workbook copy can be placed in a different folder from the original workbook, potentially with a different name and description. This is useful for creating workbook templates or backups.
### Usage notes
- The workbookId and version tag in the URL specify the tagged version of the workbook to duplicate. Retrieve the **workbookId** by calling the [/v2/workbooks](https://help.sigmacomputing.com/reference/list-workbooks) 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 workbook.
- 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
workbookId
versionTag
Request
The request body.
destinationFolderId
ID of the folder in which to place the copied workbook.
name
Name for the copied workbook as it appears in Sigma.
description
A description for the new workbook.
copyBookmarks
If set to `all` (available to admins only), every saved view (bookmark) applied to the workbook is copied. If set to `accessible`, only personal saved views and those shared with the user initiating the operation are copied. Ownership of all saved views in the duplicate workbook transfers to the user initiating the operation. If not set, saved views are not copied.
Allowed values:
Response
The response body.
workbookId
Unique identifier of the workbook.
workbookUrlId
name
url
path
latestVersion
ownerId
createdBy
The identifier of the user who created this object.
updatedBy
The identifier of the user or process that last updated this object.
createdAt
When the object was created.
updatedAt
When the object was last updated.
isArchived
description

