# Tasks

A task is an operation that executes across a workset and the content items, content types, and taxonomies it contains (for example, you could create a task to publish all content items in a workset).

## Retrieve task details

 - [GET /api/v2/cm/branches/{branchId}/tasks/{taskId}](https://api-docs.sitecore.com/sai/xm-cloud-content/content-management-api/tasks/gettask.md): Lists information about a specific task.

## Retrieve a list of tasks

 - [GET /api/v2/cm/branches/{branchId}/tasks](https://api-docs.sitecore.com/sai/xm-cloud-content/content-management-api/tasks/getlisttask.md): Lists tasks and associated details. If you don't specify any filtering parameters, you will retrieve all tasks.

## Create execution details for specific workset and task

 - [POST /api/v2/cm/branches/{branchId}/tasks](https://api-docs.sitecore.com/sai/xm-cloud-content/content-management-api/tasks/createtask.md): Creates new execution details for a specific workset and task using their IDs.

## Retrieve details

 - [GET /api/v2/cm/branches/{branchId}/tasks/{taskId}/items](https://api-docs.sitecore.com/sai/xm-cloud-content/content-management-api/tasks/gettaskitems.md): Lists task details for a specific workset.

## Update task details

 - [POST /api/v2/cm/branches/{branchId}/tasks/{taskId}/callback](https://api-docs.sitecore.com/sai/xm-cloud-content/content-management-api/tasks/callbackupdatetask.md): Updates the process status or statistics of a task.

## Log item failures for a task

 - [POST /api/v2/cm/branches/{branchId}/tasks/{taskId}/callback/log](https://api-docs.sitecore.com/sai/xm-cloud-content/content-management-api/tasks/callbacklogitemfailures.md): This endpoint can be used by external tasks to report an error while processing a specific workset item as part of a workset execution.