# Worksets

A workset brings content items, content types, and taxonomies together in a group and allows you to execute tasks on it.

## Delete a workset

 - [DELETE /api/v2/cm/branches/{branchId}/worksets/{worksetId}](https://api-docs.sitecore.com/sai/xm-cloud-content/content-management-api/worksets/deleteworkset.md): Deletes a workset. This does not delete the individual content items, content types, or taxonomies it contains {% admonition type="info" name="Note"%} You can only delete worksets that have not been used by a process. Worksets expire after 30 days. {% /admonition %}

## Retrieve a workset using its ID

 - [GET /api/v2/cm/branches/{branchId}/worksets/{worksetId}](https://api-docs.sitecore.com/sai/xm-cloud-content/content-management-api/worksets/getworkset.md): Lists the items, options, and so on that are in a workset with a specific ID.

## Partially update a workset

 - [PATCH /api/v2/cm/branches/{branchId}/worksets/{worksetId}](https://api-docs.sitecore.com/sai/xm-cloud-content/content-management-api/worksets/partialupdateworkset.md): Partially updates the content items, content types, and taxonomies that make up a particular workset using the following JSON Patch operations: add, remove, replace, move, copy, and test.

## Update a workset

 - [PUT /api/v2/cm/branches/{branchId}/worksets/{worksetId}](https://api-docs.sitecore.com/sai/xm-cloud-content/content-management-api/worksets/updateworkset.md): Updates a particular workset, including the content items, content types, taxonomies and so on.

## Retrieve a list of worksets

 - [GET /api/v2/cm/branches/{branchId}/worksets](https://api-docs.sitecore.com/sai/xm-cloud-content/content-management-api/worksets/getlistworkset.md): Lists worksets that have been created. If you don't specify any filtering parameters, you will retrieve all available worksets.

## Create a workset

 - [POST /api/v2/cm/branches/{branchId}/worksets](https://api-docs.sitecore.com/sai/xm-cloud-content/content-management-api/worksets/createworkset.md): Creates a workset to hold a group of content items, content types, or taxonomies. This allows you to run tasks for the workset.

## Retrieve all the items in a workset with a specific ID

 - [GET /api/v2/cm/branches/{branchId}/worksets/{worksetId}/items](https://api-docs.sitecore.com/sai/xm-cloud-content/content-management-api/worksets/getworksetitems.md): Lists the content items, content types, and taxonomies that are in a particular workset using its ID.