> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lacy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create label

> Create a label to tag your assistants

Create a label to tag assistants across folders (for example, `inbound` or `outbound`). Apply labels to assistants with the `label_ids` field on the [Create assistant](https://docs.lacy.ai/api-reference/assistants/create-assistant.md) and [Update assistant](https://docs.lacy.ai/api-reference/assistants/update-assistant.md) endpoints.

### Request Body

**name** `string` *required*

The label name (max 255 characters). Must be unique within your account.

**color** `string`

A color for the label badge. One of: `gray`, `slate`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `purple`, `pink`.

### Response

**message** `string`

Success message

**data** `object`

**properties**

**id** `integer`

The unique identifier of the created label

**name** `string`

The label name

**color** `string`

The label color (or `null`)

**assistants\_count** `integer`

Number of assistants this label is applied to (always `0` for a new label)

```json 201 Success Response theme={null}
{
  "message": "Label created successfully",
  "data": { "id": 3, "name": "Inbound", "color": "green", "assistants_count": 0 }
}
```

```json 422 Validation Error theme={null}
{
  "message": "The name has already been taken.",
  "errors": { "name": ["The name has already been taken."] }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.