# Labels

## List labels

 - [GET /rest/v2/labels](https://apidocs.rhythms.ai/rest/v2/labels/get_rest_v2_labels.md): Retrieves all labels and label groups via REST API

This endpoint supports filtering and pagination through query parameters. Available ransackable attributes: uuid, name, parent_uuid, is_group.

Available ransackable associations and their attributes:
- parent: parent_uuid, parent_name, parent_parent_uuid, parent_is_group

## Create a new label

 - [POST /rest/v2/labels](https://apidocs.rhythms.ai/rest/v2/labels/post_rest_v2_labels.md): Creates a new label with the provided attributes. Labels can be regular labels or groups.

## Get a specific label

 - [GET /rest/v2/labels/{id}](https://apidocs.rhythms.ai/rest/v2/labels/get_rest_v2_labels_id.md): Retrieves detailed information about a specific label by its UUID

## Update a label

 - [PUT /rest/v2/labels/{id}](https://apidocs.rhythms.ai/rest/v2/labels/put_rest_v2_labels_id.md): Updates an existing label with the specified attributes

## Delete a label

 - [DELETE /rest/v2/labels/{id}](https://apidocs.rhythms.ai/rest/v2/labels/delete_rest_v2_labels_id.md): Deletes a label. If the label has child labels, they will also be deleted.