上传文件

向指定路径上传文件，使用 multipart/form-data 格式提交。

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

请求头

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

请求参数

参数名	类型	必填	说明
file	file	是	上传的文件
path	string	否	目标路径，默认 /<原始文件名>
user_id	string	是	业务方用户 ID，用于确定所属工作空间

请求示例（curl）：

curl -X POST "https://runtime-api.invalid/v1/openapi/app/files/upload" \
  -H "Authorization: Bearer sk_xxx" \
  -F "file=@/path/to/local/data.csv" \
  -F "path=/data/data.csv" \
  -F "user_id=user123"

响应示例

{
  "code": 200,
  "data": {
    "name": "data.csv",
    "path": "/data/data.csv",
    "size": 0,
    "is_dir": false,
    "mod_time": "2026-04-27T11:00:00Z",
    "url": "https://obs.example.com/workspaces/.../data/data.csv"
  },
  "message": "",
  "trace_id": "ghi789"
}

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