---
title: "POST /v2/PurgeBlocks"
method: POST
path: "/v2/PurgeBlocks"
tags: ["Block"]
---

# POST /v2/PurgeBlocks

`POST /v2/PurgeBlocks`

Purge references to one or several missing data blocks.

This will remove all objects and in-progress multipart uploads that contain the specified data block(s). The objects will be permanently deleted from the buckets in which they appear. Use with caution.

## Query parameters

- `node` string, required

## Request body

- string[]

## Response `200`

Responses from individual cluster nodes

- MultiResponseLocalPurgeBlocksResponse
  - `error` object, required — Map of node id to error message, for nodes that were unable to complete the API call
  - `success` object, required — Map of node id to response returned by this node, for nodes that were able to successfully complete the API call

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.net/deuxfleurs/apis/garage-administration-api.md) · [All operations](https://skmtc.net/deuxfleurs/apis/garage-administration-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deuxfleurs/garage-administration-api/versions/07ffb2d0febb/schema)
