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

# 删除单条播放历史

`DELETE /play-history/entry`

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

## Query parameters

- `context_type` 'playlist' | 'tag' | '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` — 服务器错误

## Changes

- **2026-07-30** `9d0c9dd2d9a4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/songloft-org/apis/songloft-api/changes/play-history/entry/delete.md)

---

[API](https://skmtc.dev/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.dev/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/songloft-org/songloft-api/revisions/5b1368253f6c/schema)