---
title: "更新歌单创建方式"
method: PUT
path: "/settings/scan-playlist-mode"
tags: ["扫描管理"]
---

# 更新歌单创建方式

`PUT /settings/scan-playlist-mode`

设置扫描后自动创建歌单的目录归并模式。directory：每个文件夹生成独立歌单；top_level：按一级子目录合并歌单；bubble_up：歌曲同时出现在所有上级文件夹歌单。

## Request body

- HandlersScanPlaylistModeRequest
  - `mode` 'directory' | 'top_level' | 'bubble_up'

## Response `200`

返回 mode 字段

- HandlersScanPlaylistModeResponse
  - `mode` string

## Other responses

- `400` — 请求格式错误或 mode 值非法
- `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/revisions/e4d4950ef665/schema)