Delete Tax Rate
Permanently removes a tax rate. On success the mutation returns a snapshot of the rate that was deleted, so you can confirm exactly which record was removed. Any tax categories that referenced the rate keep working; only the rate is removed.
Operation
| Operation | Type | Purpose |
|---|---|---|
deleteAdminSettingsTaxRate(input:) | Mutation | Delete a tax rate |
Prerequisites
The example uses an illustrative id value. Replace it with the id of a tax rate that exists in your store — use the adminSettingsTaxRates query to discover valid ids.
Notes
- The returned node is an in-memory snapshot of the just-deleted record — its scalar fields (
_id,identifier,isZip,zipCode,zipFrom,zipTo,state,country,taxRate) still resolve so you can confirm what was removed. - Select
messagefor the success confirmation — it resolves to"Tax rate deleted successfully."on a successful delete.messageisnullon read / list / create / update; a failed delete returns a top-levelerrors[]entry instead. - Do not select the node's IRI
idfield on this mutation — the IRI cannot be generated for a deleted record and the field resolves with anerrors[]entry. Select_idinstead, as shown. - There is no mass-delete for tax rates (the admin UI ships single delete only).

