---
title: "Purge Retention"
method: POST
path: "/internal/retention/purge"
tags: ["internal"]
---

# Purge Retention

`POST /internal/retention/purge`

Run one idempotent purge pass; non-2xx makes Cloud Tasks retry.

## Headers

- `Authorization` string, required

## Request body

- RetentionPurgeRequest
  - `retentionId` string, required
  - `kind` 'success' | 'terminal' | 'watchdog'

## Response `200`

Successful Response

- RetentionPurgeResponse
  - `state` string, required
  - `deletedMorcRecords` integer
  - `deletedGatewayRecords` integer
  - `deletedBridgeRecords` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mirage/apis/mirage-video-api.md) · [All operations](https://skmtc.net/mirage/apis/mirage-video-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mirage/mirage-video-api/versions/302cafad9d70/schema)