Update a tax

Updates an existing tax’s information.

Use Cases

• Modify tax percentage rates
• Update tax descriptions
• Activate/deactivate taxes
• Change tax names

Path Parameters

• id: Tax UUID (required) - Must be a valid UUID format

Example Request

PUT /api/v0/taxes/123e4567-e89b-12d3-a456-426614174000

Example Request Body

{
  "name": "Updated Sales Tax",
  "description": "Updated sales tax rate",
  "percentage": 9.0,
  "active": true
}

Notes

• Only include fields that need to be updated
• All fields are optional in updates
• Percentage changes affect future calculations only

PUT /api/v0/taxes/{id}

Update a tax

cURL

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-secretx-client-key

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 string length: 100

Example:

"Updated Sales Tax"

description · string

Detailed description of what this tax covers

Maximum string 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

200

Successfully updated tax