# Labels



import Image from 'next/image';

Labels can be used to categorize tasks and manage task workflows according to your specific business needs. Each task can be associated with a maximum of 100 labels. Labels are an organizational tool that have no effect on system behavior.

Use Cases [#use-cases]

Common use cases include:

* Tasks that can't be completed yet might have a `blocked` or `onHold` label.
* Tasks that require review and approval by a manager might have a `pendingReview` or `escalated` label.
* Tasks that require action from a customer might have an `awaitingCustomer` or `pendingSignature` label.

Configuration [#configuration]

Before labels can be associated with a task, labels must be configured through <ApiLink name="LabelRef">LabelRef</ApiLink> configuration objects within the <ApiLink name="WorkManagementRef">WorkManagementRef</ApiLink> tenant configuration.

Here's an example of a <ApiLink name="WorkManagementRef">WorkManagementRef</ApiLink> configuration that includes `blocked`, `escalated`, and `awaitingCustomer` labels:

```json
{
	"labels": {
		"blocked": {},
		"escalated": {},
		"awaitingCustomer": {}
	}
}
```

Adding Labels to Tasks [#adding-labels-to-tasks]

Task Dashboard [#task-dashboard]

Once your configuration changes have been deployed, you can start adding labels to tasks within the Task Dashboard.

Access the Task Dashboard by navigating to the [Operations Workbench ](https://ui-ec-sandbox.socotra.com/en/operations) and selecting a tenant.

You can add labels to existing tasks in the task summary table by clicking the *+* or *Add label +* button in the label column.

<Image src="/images/labels/task-dashboard.png" alt="Task Dashboard" width={1600} height={1600} unoptimized />

You can also add labels when creating a new task in the task sidebar.

<Image src="/images/labels/new-task.png" alt="New Task" width={1600} height={1600} unoptimized />

Search for tasks with a specific label by using the label filter in the Task Dashboard.

<Image src="/images/labels/filters.png" alt="New Task" width={1600} height={1600} unoptimized />

API Endpoints [#api-endpoints]

You can also add labels to tasks when creating and updating tasks through the <ApiLink name="addTask">Add Task</ApiLink> and <ApiLink name="updateTask">Update Task</ApiLink> API endpoints.

Here's an example request for the <ApiLink name="addTask">Add Task</ApiLink> API endpoint:

```json
{
	"type": "underwriting",
	"deadlineTime": "2027-01-15T09:30:00Z",
	"references": [
		{
			"referenceType": "quote",
			"referenceLocator": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
		}
	],
	"labels": ["blocked", "escalated"]
}
```

Here's an example request for the <ApiLink name="updateTask">Update Task</ApiLink> API endpoint:

```json
{
	"addLabels": ["awaitingCustomer"]
}
```