---
title: "DELETE /api/v1/config/buckets/{slug}"
method: DELETE
path: "/api/v1/config/buckets/{slug}"
tags: ["Bucket"]
---

# DELETE /api/v1/config/buckets/{slug}

`DELETE /api/v1/config/buckets/{slug}`

## Path parameters

- `slug` string, required

## Query parameters

- `force_delete` boolean

## Response `200`

A successful response.

- Configv1DeleteBucketResponse
  - `changes` ResourceChange[] — Changes contains what resources are deleted. The bucket being deleted will always be included. When force_delete is used, the changelog will include all resources that reference the bucket that were deleted.
    - `resource` 'BUCKET' | 'DASHBOARD' | 'GRAFANA_DASHBOARD' | 'MONITOR' | 'NOTIFICATION_POLICY' | 'RECORDING_RULE' | 'MAPPING_RULE' | 'ROLLUP_RULE'
    - `slug` string
    - `action` 'CREATED' | 'UPDATED' | 'DELETED' | 'NOOP'

## Other responses

- `400` — Cannot delete the Bucket because it is in use.
- `404` — Cannot delete the Bucket because the slug does not exist.
- `500` — An unexpected error response.
- `default` — An undefined error response.

---

[API](https://skmtc.net/chronosphere/apis/config-v1-api.md) · [All operations](https://skmtc.net/chronosphere/apis/config-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chronosphere/config-v1-api/versions/530951bd2ccf/schema)