---
title: "保存主页插件网格排序"
method: PUT
path: "/settings/plugin-order"
tags: ["设置"]
---

# 保存主页插件网格排序

`PUT /settings/plugin-order`

保存用户在主页插件网格中拖拽形成的排序。order 元素为插件 entry_path，不能为空、不能重复；插件已不存在的条目会在保存时被静默清理（保存即自愈，客户端应以响应为准）。禁用插件的条目刻意保留：重新启用后位置自动恢复，与 tab-config 语义一致。

## Request body

- HandlersPluginOrderSetting
  - `order` string[]

## Response `200`

保存后的插件排序（孤儿条目已清理）

- HandlersPluginOrderSetting
  - `order` string[]

## Other responses

- `400` — 请求格式错误或校验失败
- `500` — 服务器错误

## Changes

- **2026-09-15** `94a164c257e6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/songloft-org/apis/songloft-api/changes/settings/plugin-order/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.dev/songloft-org/apis/songloft-api/revisions/9037eb86ae14?raw)