---
title: "删除单条播放历史"
method: DELETE
path: "/play-history/entry"
tags: ["播放历史"]
---

# 删除单条播放历史

`DELETE /play-history/entry`

从指定播放上下文中删除某首歌的播放记录。典型用途：清理已被移出歌单、在历史面板里显示为失效的条目。

## Query parameters

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

## Response `204`

删除成功，无内容

## Other responses

- `400` — context_type 不支持、缺少 context_key 或无效的 song_id
- `404` — 该上下文中不存在此歌曲的播放记录
- `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/e4d4950ef665/schema)