移动文件

将文件或目录移动（重命名）到指定目标路径，目标路径已存在时会返回错误。同目录下移动即为重命名。

• 接口路径：POST /v1/openapi/app/files/rename

请求头

参数名	必填	说明
Content-Type	是	application/json
Authorization	是	鉴权凭证，格式 Bearer sk_xxx

请求参数

{
  "user_id": "user123",
  "old_path": "/data/old_name.txt",
  "new_path": "/data/new_name.txt"
}

参数名	类型	必填	说明
user_id	string	是	业务方用户 ID，用于确定所属工作空间
old_path	string	是	原文件或目录路径
new_path	string	是	新路径（同目录下修改文件名即为重命名，跨目录即为移动）

响应示例

{
  "code": 200,
  "data": {
    "name": "new_name.txt",
    "path": "/data/new_name.txt",
    "size": 512,
    "is_dir": false,
    "mod_time": "2026-04-27T12:10:00Z",
    "url": "https://obs.example.com/workspaces/.../data/new_name.txt"
  },
  "message": "",
  "trace_id": "yza567"
}

响应 data 字段结构见文件对象结构。