> ## 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.

# 删除所有暂存响应

<RequestExample>
  ```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"
  ```
</RequestExample>

<ResponseExample>
  ```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"
  }
  ```
</ResponseExample>

<div className="inline-flex flex-wrap items-center gap-4 rounded-lg border px-3 py-2">
  <Badge color="gray">DELETE</Badge>
  `https://api.poixe.com/v1/recoveries?all=true`
</div>

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

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

## 鉴权与请求头

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

<ParamField header="Authorization" type="string" required>
  Bearer Token。格式为 `Bearer YOUR_API_KEY`。
</ParamField>

<ParamField header="Content-Type" type="string" required>
  必须设置为 `application/json`。
</ParamField>

## Query 参数

<ParamField query="all" type="string" required>
  必须为 `true`。用于确认执行“删除全部”。
</ParamField>

<ParamField query="dry_run" type="string">
  可选：为 `true` 时仅预演，不执行删除；响应会返回 `would_delete`。
</ParamField>

## 响应结构

<ResponseField name="deleted" type="integer">
  实际删除数量（dry\_run 时通常为 0）。
</ResponseField>

<ResponseField name="would_delete" type="integer">
  仅在 dry\_run 返回：预计将删除数量。
</ResponseField>

<ResponseField name="message" type="string">
  结果描述。
</ResponseField>

<ResponseField name="reason" type="string">
  结果原因（如 `OK` / `DRY_RUN` / `CONFIRMATION_REQUIRED`）。
</ResponseField>

<Callout type="warning" icon="info-circle">
  建议先调用 `DELETE /v1/recoveries?all=true&dry_run=true` 确认数量，再执行真实删除：
  `DELETE /v1/recoveries?all=true`。
</Callout>