---
title: "Permanently delete old trash entries"
method: POST
path: "/stats/deleted-sites/purge"
tags: ["Stats"]
---

# Permanently delete old trash entries

`POST /stats/deleted-sites/purge`

## Request

- Base URL: `https://api.nippy.host`
- URL: `https://api.nippy.host/stats/deleted-sites/purge`
- Auth: `bearer` (a scheme the document does not define)

Admin-only. Deletes the files and the row of every trash entry at least 30, 60 or 90 days old. An entry whose files cannot be deleted is kept and counted in `failed`. Records a site.purged activity per entry.

## Request body

- PurgeDeletedSitesDto
  - `olderThanDays` 30 | 60 | 90, required: Permanently delete every trash entry at least this old.

## Response `200`

- APIDeletedSitesPurgeResult
  - `count` number, required: Entries deleted for good.
  - `totalBytes` number, required: Bytes freed.
  - `failed` number, required: Entries a storage error kept; a later purge retries them.

## Other responses

- `403`: Admin access required

---

[API](https://skmtc.dev/nippy/apis/nippy-backend-api.md) · [All operations](https://skmtc.dev/nippy/apis/nippy-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nippy/apis/nippy-backend-api/revisions/7ab23f040a55?raw)