---
title: "Delete a bucket"
method: DELETE
path: "/buckets/{bucket}"
tags: ["Buckets"]
---

# Delete a bucket

`DELETE /buckets/{bucket}`

## Request

- Base URL: `https://sochain.com/api/v3`
- URL: `https://sochain.com/api/v3/buckets/{bucket}`
- Auth: API key in header `API-KEY`

Your addresses are untouched.

## Path parameters

- `bucket` string, required: Letters, numbers, - and _, up to 64 characters. Unique within your account.

## Response `200`

Success.

- object
  - `status` 'success', required
  - `data` object, required
    - `bucket` string, required: Letters, numbers, - and _, up to 64 characters. Unique within your account.
    - `deleted` unknown, required

## Other responses

- `400`: A bad parameter or body; the message says which.
- `401`: An invalid key, no key where one is needed (buckets, webhooks, /account_info), a locked account or expired plan, or both the month's requests and the keyless rate used up. Kept as 401, with this message, for v3 compatibility.
- `403`: A read-only key, or a change past your plan's limits: data.error_message says which.
- `404`: Not found.
- `503`: Briefly unavailable; retry with backoff. May carry Retry-After.

---

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