---
title: "删除歌单"
method: DELETE
path: "/playlists/{id}"
tags: ["歌单管理"]
---

# 删除歌单

`DELETE /playlists/{id}`

根据歌单ID删除歌单。delete_songs=true 时，同时删除仅属于本歌单的孤儿歌曲（不属于任何其他歌单，含内置的收藏/电台收藏保护）——本地歌曲连同磁盘文件一并删除，网络/电台歌曲清理数据库记录与缓存。

## Path parameters

- `id` integer, required

## Query parameters

- `delete_songs` boolean

## Response `200`

删除成功，含连带清理的歌曲数 deleted_songs

- object

## Other responses

- `400` — 无效的歌单ID
- `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/77467de6ed1b/schema)