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

# 保存曲库浏览视图配置

`PUT /settings/library-browse`

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

## Request body

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

## Response `200`

保存后的配置

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

## Other responses

- `400` — 请求格式错误或校验失败
- `500` — 保存配置失败

## Changes

- **2026-07-15** `d345c291467b` — 1 info
  - endpoint added
- **2026-06-26** `be19914b7eed` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/songloft-org/apis/songloft-api/changes/settings/library-browse/put.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)