Edit a tax jurisdiction

Goal

Update an existing jurisdiction’s name, country, level, or region.

Who it is for

tax.manage.

Preconditions

• Jurisdiction exists (GET /tax/jurisdictions/{id}).
• API supports PUT /tax/jurisdictions/{id} with the same fields as create (code, name, country, level, region, is_active).

Steps

1. Open the jurisdiction from Tax jurisdictions.
2. Use the detail/edit path when offered in the UI. If the list form only posts creates, update via the API-backed edit flow once the form is populated for the selected id — do not invent a second code for the same geography.
3. Keep code stable if determination rules already reference the jurisdiction id; change labels/country/level/region as needed.
4. Save and confirm the list reflects the new name/country/level.

Result

Determination rules keep pointing at the same jurisdiction id with corrected labels.

Hard stops

• Validation failures mirror create (code, name, country size, level enum).

Related

• Create
• Troubleshoot