PUT
/
api
/
v0
/
taxes
/
{id}
Update a tax
curl --request PUT \
  --url https://api.devdraft.ai/api/v0/taxes/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "name": "Updated Sales Tax",
  "description": "Updated description for retail sales tax",
  "percentage": 9.5,
  "active": false,
  "appIds": [
    "app_123e4567-e89b-12d3-a456-426614174000"
  ]
}'

Authorizations

​
x-client-secret
string
header
required

Your secret API key. Keep this secure and never expose it in client-side code.

Path Parameters

​
id
string<uuid>
required

Tax unique identifier (UUID)

Example:

"tax_123e4567-e89b-12d3-a456-426614174000"

Body

application/json

Tax update data - only include fields you want to update

​
name
string

Tax name for identification and display purposes

Maximum length: 100
Example:

"Updated Sales Tax"

​
description
string

Detailed description of what this tax covers

Maximum length: 255
Example:

"Updated description for retail sales tax"

​
percentage
number

Tax rate as a percentage (0-100)

Required range: 0 <= x <= 100
Example:

9.5

​
active
boolean

Whether this tax is currently active and can be applied

Example:

false

​
appIds
string<uuid>[]

Array of app IDs where this tax should be available

Example:
["app_123e4567-e89b-12d3-a456-426614174000"]

Response

Successfully updated tax