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

# DeletePrebuild

`POST /gitpod.v1.PrebuildService/DeletePrebuild`

Deletes a prebuild.

 Prebuilds are automatically deleted after some time. Use this method to
 manually delete a prebuild before automatic cleanup, for example to remove
 a prebuild that should no longer be used.

 Deletion is processed asynchronously. The prebuild will be marked for deletion
 and removed from the system in the background.

 ### Examples

 - Delete prebuild:

   Marks a prebuild for deletion and removes it from the system.

   ```yaml
   prebuildId: "07e03a28-65a5-4d98-b532-8ea67b188048"
   ```

## Request body

- GitpodV1DeletePrebuildRequest
  - `prebuildId` string, uuid, required — prebuild_id specifies the prebuild to delete

## Response `200`

Success

- GitpodV1DeletePrebuildResponse

## 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)