---
title: "保存用户偏好设置"
method: PUT
path: "/settings/user-preferences"
tags: ["设置"]
---

# 保存用户偏好设置

`PUT /settings/user-preferences`

保存用户跨设备同步的偏好设置。客户端登录后拉取、修改偏好时推送，实现多设备间偏好同步。

## Request body

- HandlersUserPreferencesSetting
  - `audio_quality` string
  - `local_cache_max_size` integer
  - `play_mode` string
  - `playlist_view_mode` string
  - `theme_mode` string
  - `volume` number

## Response `200`

保存后的用户偏好设置

- HandlersUserPreferencesSetting
  - `audio_quality` string
  - `local_cache_max_size` integer
  - `play_mode` string
  - `playlist_view_mode` string
  - `theme_mode` string
  - `volume` number

## 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)