---
title: "Permanently purge a trashed handover after retention"
method: DELETE
path: "/handovers/{id}"
---

# Permanently purge a trashed handover after retention

`DELETE /handovers/{id}`

## Request

- Base URL: `https://handover.sh/api/v1`
- URL: `https://handover.sh/api/v1/handovers/{id}`
- Auth: HTTP bearer

Metadata is removed permanently. Content-addressed object bytes are deleted only when no remaining artifact references them.

## Path parameters

- `id` string, required

## Response `204`

Handover purged

## Other responses

- `409`: The handover is not trashed or its retention window remains active.

---

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