上传工作区文件记录

上传未关联到卷的工作区文件记录。

POST https://api.moi.matrixorigin.cn/v5/workspaces/{id}/files

调用前准备

BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。

准备目标工作区个人访问令牌;WORKSPACE_ID须与路径工作区一致,FILE_ID来自实际文件结果。BASE_URL包含同环境产品前缀,示例文件/ID仅为占位值。

请求参数

curl --fail-with-body -sS -X POST "$BASE_URL/workspaces/$WORKSPACE_ID/files" \
  -H "X-API-Key: $MOI_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -F "file=@$UPLOAD_FILE;type=text/plain" \
  -F "initial_ref_count=0"

字段

类型

是否必填

说明

file

file

是

multipart 文件。

initial_ref_count

integer

否

初始引用计数,默认0,范围0至2147483647。

成功为HTTP201、数值code=0。上传本身不产生卷关联或智能体产物发布;正引用计数会影响删除。

成功响应

{
  "code": 0,
  "data": {
    "file_id": "file-example",
    "original_name": "sample.txt",
    "size": 7,
    "md5": "5177a58dc65c8a14dc90c69db3bf3dd2"
  }
}

成功数值code=0;data含file_id、original_name、size、md5。没有msg字段。

错误响应

{
  "code": 2,
  "message": "示例错误信息"
}

请求字段无效为400/2;业务上传失败按数值code/message返回,内部写入失败可500/1。

最后更新于