---
title: "Update a tax code"
method: PATCH
path: "/v1/tax-codes/{tax_code_id}"
tags: ["Tax Codes"]
---

# Update a tax code

`PATCH /v1/tax-codes/{tax_code_id}`

Updates modifiable fields of an existing tax code. If components are provided, all existing components are replaced. At least one field must be provided.

## Path parameters

- `tax_code_id` string, uuid, required

## Request body

- PatchedTaxCodeUpdateSchema
  - `name` string, nullable — Name of the tax code.
  - `external_id` string, nullable — External identifier for the tax code.
  - `components` TaxComponentInputSchema[], nullable — List of tax components. If provided, replaces all existing components.
    - `external_id` string, nullable — External identifier for the tax component.
    - `name` string, required — Name of the tax component.
    - `rate` string, required — Rate of the tax component.

## Response `200`

Tax code updated successfully

- TaxCodeOutputSchema
  - `id` string, uuid, required — Unique identifier for the tax code.
  - `external_id` string, nullable — External identifier for the tax code.
  - `name` string, required — Name of the tax code.
  - `effective_rate` string, required — Effective rate of the tax code.
  - `components` TaxComponentOutputSchema[] — List of tax components associated with the tax code.
    - `id` string, uuid, required — Unique identifier for the tax component.
    - `external_id` string, nullable — External identifier for the tax component.
    - `name` string, required — Name of the tax component.
    - `rate` string, required — Rate of the tax component.

## Other responses

- `400` — Invalid request data
- `404` — Tax code not found

---

[API](https://skmtc.dev/floatfinancial/apis/float-public-api.md) · [All operations](https://skmtc.dev/floatfinancial/apis/float-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/floatfinancial/float-public-api/revisions/a3c42eb1b312/schema)