---
title: "patchTax"
method: PATCH
path: "/v1/tax/{taxId}"
tags: ["Tax"]
---

# patchTax

`PATCH /v1/tax/{taxId}`

Partially update a specific tax entity's properties by a given id and a given payload

## Path parameters

- `taxId` string, uuid, required

## Request body

- TaxPatch
  - `_schema` 'tax'
  - `active` boolean
  - `description` string
  - `region` string
  - `rate` union
    - string
    - number
  - `type` 'VAT' | 'Custom'
  - `_tags` string[], nullable
  - `_purpose` string[], nullable
  - `_files` BaseRelation
    - `$relation` object[], required
      - `entity_id` string, uuid
      - `_tags` string[], nullable
  - `_manifest` string[] — Manifest ID used to create/update the entity
  - `__additional` object, nullable — Additional fields that are not part of the schema

## Response `200`

Tax entity response

- Tax
  - `_id` string, uuid
  - `_schema` 'tax', required
  - `_org` string, required — Organization Id the entity belongs to
  - `_tags` string[], nullable
  - `_files` BaseRelation
    - `$relation` object[], required
      - `entity_id` string, uuid
      - `_tags` string[], nullable
  - `_owners` BaseEntityOwner[]
    - `org_id` string, required
    - `user_id` string
  - `_title` string
  - `_created_at` string, date-time
  - `_updated_at` string, date-time
  - `_acl` BaseEntityAcl — Access control list (ACL) for an entity. Defines sharing access to external orgs or users.
    - `view` string[]
    - `edit` string[]
    - `delete` string[]
  - `active` boolean, required
  - `description` string
  - `region` string, required
  - `rate` union, required
    - string
    - number
  - `type` 'VAT' | 'Custom', required
  - `_purpose` string[], nullable
  - `_manifest` string[] — Manifest ID used to create/update the entity
  - `__additional` object, nullable — Additional fields that are not part of the schema

## Other responses

- `400` — Any error based on client data errors
- `500` — Any error based on the server-side

---

[API](https://skmtc.dev/epilot/apis/product-api.md) · [All operations](https://skmtc.dev/epilot/apis/product-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/epilot/product-api/revisions/246cfb2edf7f/schema)