---
title: "批量整理歌曲文件"
method: POST
path: "/songs/organize"
tags: ["歌曲管理"]
---

# 批量整理歌曲文件

`POST /songs/organize`

批量移动/重命名本地歌曲文件到指定目录结构。target_path 为相对于 music_path 的路径（含目录和文件名），扩展名必须与原文件一致。CUE 拆分歌曲会被跳过（status=skip）；目标文件已存在时拒绝覆盖（status=error）。music_path 由服务端自取。

## Request body

- ServicesOrganizeItem[]
  - `id` integer
  - `target_path` string

## Response `200`

整理结果

- ServicesOrganizeResult[]
  - `error` string
  - `file_path` string
  - `id` integer
  - `status` string

## Other responses

- `400` — 请求错误

---

[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/revisions/d5abb8b643e9/schema)