---
title: "Cleanup Unused"
method: POST
path: "/api/v1/admin/api-keys/cleanup-unused"
tags: ["admin-api-keys"]
---

# Cleanup Unused

`POST /api/v1/admin/api-keys/cleanup-unused`

## Request

- Base URL: `https://api.slidemaster.tw` (the document declares no server; this is the origin it was published from)
- URL: `https://api.slidemaster.tw/api/v1/admin/api-keys/cleanup-unused`
- Auth: none declared

Admin: 批次刪除「從未被呼叫過、且建立超過 N 天」的 API keys。

安全預設 dry_run=True，先看清單，確認後再帶 ?dry_run=false 實際刪除。

Examples:
    GET /admin/api-keys/cleanup-unused?days=30           → 預覽 30 天前未用的
    POST /admin/api-keys/cleanup-unused?days=30&dry_run=false → 實際刪除

## Query parameters

- `days` integer: 建立距今天數閾值
- `dry_run` boolean: True = 預覽不刪除（預設）；False = 實際刪除

## Headers

- `Authorization` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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