---
title: "保存曲库浏览视图配置"
method: PUT
path: "/settings/library-browse"
tags: ["设置"]
---

# 保存曲库浏览视图配置

`PUT /settings/library-browse`

保存用户自定义的曲库浏览页视图显示与顺序。每个 view 的 key 必须属于合法的 14 个 key 且不能重复；未出现的 key 会按默认顺序补到末尾（visible=true），保证返回完整 14 项。

## Request body

- HandlersLibraryBrowseSetting
  - `views` HandlersLibraryBrowseView[]
    - `key` string
    - `visible` boolean

## Response `200`

保存后的配置

- HandlersLibraryBrowseSetting
  - `views` HandlersLibraryBrowseView[]
    - `key` string
    - `visible` boolean

## Other responses

- `400` — 请求格式错误或校验失败
- `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)