---
title: "Delete a price tier"
method: DELETE
path: "/public/v1/price-tiers/{id}"
tags: ["PriceTier"]
---

# Delete a price tier

`DELETE /public/v1/price-tiers/{id}`

Soft-deletes the tier. It stops applying to new orders immediately; order items already priced
by it keep the frozen version they reference, so their prices don't change. Its removal from
statewide marketplace price discovery propagates asynchronously, so a 204 confirms the tier was
deleted, not that every buyer-facing surface has dropped it yet. Deleting an unknown or
already-deleted tier returns 404.

Required permission: `settings_permissions_price_tiers`.

## Path parameters

- `id` string, required

## Response `204`

No Content

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission
- `404` — Not Found

---

[API](https://skmtc.dev/distru/apis/distru-api.md) · [All operations](https://skmtc.dev/distru/apis/distru-api/llms.txt) · [OpenAPI document](https://skmtc.dev/distru/apis/distru-api/revisions/421cc4d0838b?raw)
