---
title: "Close the compaction headroom grant (idempotent)"
method: DELETE
path: "/vaults/v1/{vault_id}/compaction-grant"
tags: ["vault"]
---

# Close the compaction headroom grant (idempotent)

`DELETE /vaults/v1/{vault_id}/compaction-grant`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/vaults/v1/{vault_id}/compaction-grant`
- Auth: one of:
  - API key in header `SIGN-IN-WITH-X`
  - HTTP bearer
  - HTTP bearer

Idempotent close, called once a compaction's prune completes. `{closed: true}` when an active grant existed and was just closed; `{closed: false}` when there was none (already closed, already expired, or never opened) — Faithful, never a pretend close.

## Path parameters

- `vault_id` string, required

## Headers

- `SIGN-IN-WITH-X` string, required

## Response `200`

Close outcome

- object
  - `closed` boolean, required

## Other responses

- `403`: Not authorized (VAULT_ACCESS_DENIED)

---

[API](https://skmtc.dev/run402/apis/run402-api.md) · [All operations](https://skmtc.dev/run402/apis/run402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/run402/apis/run402-api/revisions/893607557f50?raw)