> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poixe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 删除所有暂存响应

```bash curl theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Dry run (recommended)
curl -X DELETE "https://api.poixe.com/v1/recoveries?all=true&dry_run=true" \
  -H "Authorization: Bearer $POIXE_API_KEY" \
  -H "Content-Type: application/json"

# Real delete
curl -X DELETE "https://api.poixe.com/v1/recoveries?all=true" \
  -H "Authorization: Bearer $POIXE_API_KEY" \
  -H "Content-Type: application/json"
```

```json real delete theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "deleted": 2,
  "message": "All recovery records deleted successfully.",
  "reason": "OK"
}
```

```json dry run delete theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "deleted": 0,
  "would_delete": 2,
  "message": "Dry run only. No records deleted.",
  "reason": "DRY_RUN"
}
```

DELETE
`https://api.poixe.com/v1/recoveries?all=true`

删除当前用户的全部暂存记录。该操作为破坏性操作，必须显式携带 `all=true` 作为确认参数（防误触）。

你也可以先使用 `dry_run=true` 进行预演：仅返回预计删除数量，不执行真实删除。

## 鉴权与请求头

所有 API 请求都必须在 HTTP Header 中包含您的 API 密钥。

**Authorization** `string` *required*

Bearer Token。格式为 `Bearer YOUR_API_KEY`。

**Content-Type** `string` *required*

必须设置为 `application/json`。

## Query 参数

**all** `string` *required*

必须为 `true`。用于确认执行“删除全部”。

**dry\_run** `string`

可选：为 `true` 时仅预演，不执行删除；响应会返回 `would_delete`。

## 响应结构

**deleted** `integer`

实际删除数量（dry\_run 时通常为 0）。

**would\_delete** `integer`

仅在 dry\_run 返回：预计将删除数量。

**message** `string`

结果描述。

**reason** `string`

结果原因（如 `OK` / `DRY_RUN` / `CONFIRMATION_REQUIRED`）。

建议先调用 `DELETE /v1/recoveries?all=true&dry_run=true` 确认数量，再执行真实删除：
`DELETE /v1/recoveries?all=true`。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.