---
title: "保存底部导航栏 Tab 配置"
method: PUT
path: "/settings/tab-config"
tags: ["设置"]
---

# 保存底部导航栏 Tab 配置

`PUT /settings/tab-config`

保存用户自定义的底部导航栏 Tab 配置。首页和设置固定显示（不在配置中），可选项为歌曲库、歌单和插件 Tab，可选项总数不超过 10 个。每个插件 Tab 的 entry_path 和 name 不能为空，且不能重复。移动端超过 5 个时自动折叠到「更多」菜单。

## Request body

- HandlersTabConfigSetting
  - `plugin_tabs` HandlersPluginTabEntry[]
    - `entry_path` string
    - `name` string
    - `plugin_id` integer
  - `show_library` boolean
  - `show_playlists` boolean

## Response `200`

保存后的 Tab 配置

- HandlersTabConfigSetting
  - `plugin_tabs` HandlersPluginTabEntry[]
    - `entry_path` string
    - `name` string
    - `plugin_id` integer
  - `show_library` boolean
  - `show_playlists` 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/e4d4950ef665/schema)