---
title: "Delete a bin"
method: DELETE
path: "/public/v1/bins/{id}"
tags: ["Bin"]
---

# Delete a bin

`DELETE /public/v1/bins/{id}`

Permanently delete a bin. This is a hard delete — the bin is gone for good and cannot be recovered; there is no soft-delete or undo.

Deleting a bin also detaches it from everything associated to it: any packages, batches, plants, plant groups and assembly outputs that referenced this bin are unbinned. Those records, and their inventory, are not deleted — they simply no longer point to any bin. Nothing about inventory quantities, packages, or compliance changes; only the bin association is removed.

Returns 404 if no bin with that ID belongs to your company (the lookup is company-scoped), and 204 with no body on success.

Bins only exist for companies that have bin inventory tracking enabled; if it is disabled the request is rejected.

Required permission: `settings_permissions_bins`.

## 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-service-production.skmtc.workers.dev/v1/apis/distru/distru-api/revisions/eb775b7b6ee0/schema)