---
title: "Update a label"
description: "Rename or recolour. Both fields are replaced, so send the name even when only the colour changes."
url: "https://openemail.uk/docs/api/labels/update"
area: "API"
category: "Mailbox"
---

# Update a label

Rename or recolour. Both fields are replaced, so send the name even when only the colour changes.

`PATCH /labels/{id}`

## PATCH /labels/{id}

Rename or recolour. Both fields are replaced, so send the name even when only the colour changes.

## Example

Needs `labels:write`.

**curl**

```
curl -X PATCH "$OE/labels/USER_INVOICES" -H "$AUTH" -H "Content-Type: application/json" \
  -d '{ "name": "Billing", "color": { "backgroundColor": "#fce8e6", "textColor": "#c5221f" } }'
```

**Response**

```
{ "object": "label", "id": "USER_INVOICES", "name": "Billing" }
```