---
title: "清空播放上下文的播放历史"
method: DELETE
path: "/play-history"
tags: ["播放历史"]
---

# 清空播放上下文的播放历史

`DELETE /play-history`

删除指定播放上下文内的全部播放记录，返回实际删除条数。上下文不存在或本就没有记录时返回 deleted=0，不视为错误。

## Query parameters

- `context_type` 'playlist' | 'artist' | 'album' | 'genre' | 'year' | 'decade' | 'language' | 'style', required
- `context_key` string, required

## Response `200`

成功返回 {deleted: 删除条数}

- object

## Other responses

- `400` — context_type 不支持或缺少 context_key
- `500` — 服务器错误

---

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