---
title: "Delete the target VCH"
method: DELETE
path: "/target/{target}/vch/{vchId}"
---

# Delete the target VCH

`DELETE /target/{target}/vch/{vchId}`

A `DELETE` request on a VCH resource will delete that VCH. By default, the request will fail if the VCH contains powered on Container VMs. By default, volume stores will not be deleted.

## Path parameters

- `target` string, required
- `vchId` string, required

## Query parameters

- `thumbprint` string

## Request body

- DeletionSpecification
  - `containers` 'off' | 'all'
  - `volume_stores` 'none' | 'all'

## Response `202`

A vSphere task for work that is occurring asynchronously, or null if the operation is complete.

- object
  - `task` string, uri

## Other responses

- `default` — An error occurred

---

[API](https://skmtc.net/vmware/apis/vic-machine-api.md) · [All operations](https://skmtc.net/vmware/apis/vic-machine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vmware/vic-machine-api/versions/022f4170e516/schema)