---
title: "Delete Cluster"
method: DELETE
path: "/v1/clusters/{cluster_id}"
tags: ["Clusters"]
---

# Delete Cluster

`DELETE /v1/clusters/{cluster_id}`

This endpoint deletes a cluster and all its resources including:
    - Running Ray jobs (cancels active jobs)
    - Cluster triggers
    - Execution history (clustering_results)
    - S3 artifacts (parquet files, documents, members)
    - Related tasks
    - Clustering jobs
    - MongoDB cluster metadata
    - Output collections created by the cluster (by default)

    By default, output collections created by the cluster are cascade-deleted
    along with the cluster. Pass `cascade_output_collections=false` to preserve
    them (useful when the cluster output documents were enriched / promoted
    into user-managed data).

    The deletion is performed synchronously and returns when complete.

## Path parameters

- `cluster_id` string, required — Cluster ID

## Query parameters

- `cascade_output_collections` boolean — When true (default), the cluster's output collections are deleted alongside the cluster. Set to false to preserve them.

## Response `200`

Successful Response

- unknown

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

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