# Labels

Labels are used to categorize your images or templates by assigning tags to them.
Each label has a unique name, a color represented as a hexadecimal code, and a type
indicating whether it is used for images or templates (resources).

## List labels

 - [GET /v1/REST/labels](https://dev.mailjet.com/openapi/openapi-passport/labels/get_v1_labels.md): Retrieve a list of your labels. Labels are used to categorize your images or templates by assigning tags to them.

## Create a label

 - [POST /v1/REST/labels](https://dev.mailjet.com/openapi/openapi-passport/labels/post_v1_labels.md): Create a label to categorize resources (templates) or images for better organization. Each label has a unique name, a color represented as a hexadecimal code, and a type indicating whether it is used for images or templates.

## Retrieve a single label

 - [GET /v1/REST/labels/{id}](https://dev.mailjet.com/openapi/openapi-passport/labels/get_v1_label_by_id.md): Retrieve a single label using its unique ID. To obtain a valid id, first call GET /v1/REST/labels to list your labels.

## Update a label

 - [PUT /v1/REST/labels/{id}](https://dev.mailjet.com/openapi/openapi-passport/labels/put_v1_label.md): Update a label using its unique ID. You can update its name and color. All PUT requests behave like PATCH requests — only the specified properties are updated. To obtain a valid id, first call GET /v1/REST/labels to list your labels.

## Delete a label

 - [DELETE /v1/REST/labels/{id}](https://dev.mailjet.com/openapi/openapi-passport/labels/delete_v1_label.md): Permanently delete a label using its unique ID. Once a label is deleted, it will be removed from all images or templates and cannot be restored.