---
title: "Update tax rate settings"
method: PATCH
path: "/tax-rates/{tax_rate_id}"
tags: ["Accounting", "Tax rates"]
---

# Update tax rate settings

`PATCH /tax-rates/{tax_rate_id}`

## Request

- Base URL: `https://b2b.revolut.com/api/1.0`
- URL: `https://b2b.revolut.com/api/1.0/tax-rates/{tax_rate_id}`
- Auth: HTTP bearer

Update settings for a specific tax rate, based on its ID.

:::note
This operation is not supported for [externally managed tax rates](https://developer.revolut.com/docs/guides/manage-accounts/accounting/manage-tax-rates#externally-managed-settings).
:::

For more details, see the guides: [Manage accounting settings](https://developer.revolut.com/docs/guides/manage-accounts/accounting/manage-accounting-settings) and [Manage tax rates](https://developer.revolut.com/docs/guides/manage-accounts/accounting/manage-tax-rates).

## Path parameters

- `tax_rate_id` string, uuid, required

## Request body

- UpdateTaxRateRequest: The new setting for the tax rate.
  - `name` string: The new name for the tax rate.

## Response `204`

Tax rate updated

## Other responses

- `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 tax rate that you're trying to update cannot be found. This can happen, for example, when the tax rate doesn't exist, or the provided tax rate ID is incorrect.
- `409`: Conflict Request conflicts with the current state of the resource. Returned, for example, when a tax rate with the provided name already exists.
- `422`: Unprocessable entity - tax rate cannot be updated due to business rules Returned, for example, when you have an accounting software integration connected to your Revolut Business account, and tax rates 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.
- `default`: Unexpected error

---

[API](https://skmtc.dev/revolut/apis/business-api.md) - [All operations](https://skmtc.dev/revolut/apis/business-api/llms.txt) - [OpenAPI document](https://skmtc.dev/revolut/apis/business-api/revisions/be089d9fa8b4?raw)