---
api: 'Business API'
---

# Delete a label

Delete a specific label, based on the IDs of the label and its label group.

:::note
This operation is not supported for [externally managed labels](/docs/guides/manage-accounts/accounting/manage-labels-and-label-groups#externally-managed-settings).
:::

Once the label is deleted, it will not be returned by the API or in the Revolut Business app, and:
- You will not be able to apply it to new financial records (e.g. expenses). 
- Existing records with this label that have not been completed will be marked as invalid, and you'll need to update them to use a different label.
- Completed records will not be affected by the change. 

A successful response does not get any content in return.

For more details, see the guides: [Manage accounting settings](/docs/guides/manage-accounts/accounting/manage-accounting-settings) and [Manage labels and label groups](/docs/guides/manage-accounts/accounting/manage-labels-and-label-groups).

## Endpoint

DELETE `/label-groups/{group_id}/labels/{label_id}`

## Parameters

### path parameters

- `group_id` (string, required)
  The ID of the label group to which the label belongs.

- `label_id` (string, required)
  The ID of the label to delete.

## Returns

### 204

Label deleted

## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad Request  Returned, for example, when a required parameter is missing or malformatted. |
| 401 | Unauthorized – authentication credentials are missing or invalid  Returned when the request was not fulfilled because authentication has failed or has not been provided. |
| 403 | Action forbidden - insufficient permissions to perform this action  Returned, for example, when you don't have permissions necessary to perform this action. |
| 404 | Not found  Returned when the label that you're trying to delete cannot be found. This can happen, for example, when the label doesn't exist, or the provided label ID is incorrect. |
| 422 | Unprocessable entity - label cannot be deleted due to business rules   Returned, for example, when you have an accounting software integration connected to your Revolut Business account, and labels are managed by that integration.  The request is well-formed and the server understands it, but the operation cannot be performed because the resource state doesn't permit it. Retrying the same request won't succeed. |
| 429 | Too many requests  Returned, for example, when the rate limit has been exceeded. If the response includes the `Retry-After` instruction, please respect it and refrain from earlier retry attempts. |
| 500 | Internal server error  An unexpected application error occurred. |
| 503 | Service Unavailable  The system is temporarily unavailable. If the response includes the `Retry-After` header instruction, please respect it and refrain from earlier retry attempts. |