---
title: "DeleteWarmPool"
method: POST
path: "/gitpod.v1.PrebuildService/DeleteWarmPool"
tags: ["gitpod.v1.PrebuildService"]
---

# DeleteWarmPool

`POST /gitpod.v1.PrebuildService/DeleteWarmPool`

Deletes a warm pool.

 Deletion is processed asynchronously. The pool is marked for deletion
 and the runner drains instances in the background.

 Warm pools are also automatically deleted when prebuilds are disabled
 on the project or the environment class is removed from the prebuild
 configuration.

 ### Examples

 - Delete warm pool:

   ```yaml
   warmPoolId: "a1b2c3d4-5678-9abc-def0-1234567890ab"
   ```

## Request body

- GitpodV1DeleteWarmPoolRequest
  - `warmPoolId` string, uuid, required — warm_pool_id specifies the warm pool to delete

## Response `200`

Success

- GitpodV1DeleteWarmPoolResponse

## Other responses

- `default` — Error

---

[API](https://skmtc.net/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.net/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/versions/44d50c2ac284/schema)