---
title: "Delete builder cache"
method: POST
path: "/build/prune"
tags: ["Image"]
---

# Delete builder cache

`POST /build/prune`

## Query parameters

- `keep-storage` integer
- `reserved-space` integer
- `max-used-space` integer
- `min-free-space` integer
- `all` boolean
- `filters` string

## Response `200`

No error

- object
  - `CachesDeleted` string[]
  - `SpaceReclaimed` integer — Disk space reclaimed in bytes

## Other responses

- `500` — Server error

## Changes

- **2026-07-17** `f56f003a4e97` — 3 info
  - added the new optional `query` request parameter `max-used-space`
  - added the new optional `query` request parameter `min-free-space`
  - added the new optional `query` request parameter `reserved-space`
- **2023-04-21** `04e23a3e68d7` — 3 warning
  - deleted the `query` request parameter `max-used-space`
  - deleted the `query` request parameter `min-free-space`
  - deleted the `query` request parameter `reserved-space`

[Change history](https://skmtc.dev/openshift/apis/docker-engine-api/changes/build/prune/post.md)

---

[API](https://skmtc.dev/openshift/apis/docker-engine-api.md) · [All operations](https://skmtc.dev/openshift/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openshift/docker-engine-api/revisions/f56f003a4e97/schema)