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

# Update accounting category settings

Update settings for a specific accounting category, based on its ID.

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

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

## Endpoint

PATCH `/accounting-categories/{accounting_category_id}`

## Parameters

### path parameters

- `accounting_category_id` (string, required)
  The ID of the accounting category to update.

## Request body

### Attributes

- `name` (string, optional)
    The new full name for the accounting category.
- `code` (string, optional)
    The new code name for the accounting category.
- `default_tax_rate_id` (string, optional)
    The ID of the new default [tax rate](/docs/api/business#get-tax-rate) that should be applied to items in this accounting category unless overridden for a specific item.

## Returns

### 204

Accounting category updated

## 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 accounting category that you're trying to modify cannot be found. This can happen, for example, when the accounting category doesn't exist, or the provided category ID is incorrect. |
| 409 | Conflict  Request conflicts with the current state of the resource. Returned, for example, when an accounting category with the provided name and/or code already exists. |
| 422 | Unprocessable entity - accounting category cannot be updated due to business rules   Returned, for example, when you have an accounting software integration connected to your Revolut Business account, and accounting categories are managed by that integration. May also be returned if you try to modify a category that has already been deleted, or when you try to clear `name` and/or `code` values using `null`.   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. |