---
title: "Delete a virtual cluster"
method: DELETE
path: "/gateway_manager/v1/virtual-clusters/{id}"
tags: ["Gateway Manager"]
---

# Delete a virtual cluster

`DELETE /gateway_manager/v1/virtual-clusters/{id}`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/gateway_manager/v1/virtual-clusters/{id}`
- Auth: none declared

Deletes a virtual cluster. Does not affect member physical clusters.

## Path parameters

- `id` string, required

## Response `200`

Result of deleting the virtual cluster

- GatewayManagerDeleteVirtualClusterByIdResponse200
  - `state` string
  - `result` GatewayManagerV1VirtualClustersIdDeleteResponsesContentApplicationJsonSchemaResult
  - `message` string

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Gateway Manager` added
  - api tag `gatewayManager` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/gateway_manager/v1/virtual-clusters/:id/delete.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)
