创建条目 - MemoryLake AI

POST /openapi/memorylake/api/v1/drives/items

一个接口，两种模式 — 由 item_type 字段决定：

文件夹（item_type: "folder"） — 在文件库中创建一个空文件夹。
文件（item_type: "file"） — 注册一个字节已通过分块上传存入存储的文件。您必须先调用创建上传会话并收集每个分块的 ETag。

请选择下方与您要创建的条目类型相匹配的标签页。不同模式的必填字段不同。

parent_item_id 接受别名 MY_SPACE（您的工作空间根目录）。直接传入即可，无需查询根目录 ID。您也可以传入任意文件夹的 item_id 以嵌套到更深层级。

所需权限： drive:item_add · service流程说明（文件模式）： 以 item_type: "file" 模式调用此接口是文件库上传流程的第 2 步；第 1 步是创建上传会话（相同权限）。如需让文件出现在项目中，请调用导入文档 — 该操作还额外需要 project:doc_add 权限。

请求体

创建文件夹
创建文件

string

必填

必须为 "folder"。

string

必填

父文件夹 — MY_SPACE 或任意文件夹的 item_id。

string

必填

文件夹名称，例如 Q2 Reports。

string

默认值:"rename"

当 parent_item_id 中已存在同名条目时的行为：

rename（默认） — 追加数字后缀（Q2 Reports_1）。
deny — 以 409 DRIVE_ITEM_CONFLICT 失败。

object

扩展属性 — 用于存放调用方自定义元数据的 字符串 → 字符串 映射。

此调用用于为您先前发起的上传收尾 — 不会传输字节。在执行到这一步之前，您应该已经：

调用创建上传会话并传入 file_size，收到 upload_id 以及每个分块的预签名 URL。
将每个分块 PUT 到其 URL，并保存每次响应的 ETag 头。

string

必填

必须为 "file"。

string

必填

父文件夹 — MY_SPACE 或任意文件夹的 item_id。

string

必填

文件名，例如 report.pdf。

object

必填

指向已完成的分块上传。

显示 from

string

必填

创建上传会话返回的 upload_id。

array

必填

每个已上传分块对应一项。必须按顺序包含全部分块。

显示 part_etags 数组项

integer

必填

分块编号（从 1 开始）。必须与上传会话中的 number 一致。

string

必填

PUT 该分块时返回的 ETag 头值。

string

默认值:"rename"

当 parent_item_id 中已存在同名条目时的行为：

rename（默认） — 追加数字后缀（report_1.pdf）。
deny — 以 409 DRIVE_ITEM_CONFLICT 失败。
overwrite — 覆盖文件库中现有文件的内容。现有的 item_id 保持不变。
replace — 删除现有文件并创建新文件。会签发新的 item_id；此前对旧 ID 的引用将失效。

overwrite 仅替换文件库中存储的文件字节 — 不会重新处理或重新索引此前从该文件导入的任何项目文档。要将新内容同步到项目中，请在覆盖后再次调用导入文档（或改用一个新文件）。

object

扩展属性 — 用于存放调用方自定义元数据的 字符串 → 字符串 映射。

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v1/drives/items' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "item_type": "folder",
    "parent_item_id": "MY_SPACE",
    "name": "Q2 Reports"
  }'

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v1/drives/items' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "item_type": "file",
    "parent_item_id": "MY_SPACE",
    "name": "report.pdf",
    "from": {
      "upload_id": "upl-abc123def456",
      "part_etags": [
        { "number": 1, "etag": "d41d8cd98f00b204e9800998ecf8427e" },
        { "number": 2, "etag": "f6e5d4c3b2a10987f6e5d4c3b2a10987" }
      ]
    }
  }'

响应

文件夹和文件的响应结构相同。

object

显示已创建的条目

string

所创建条目的 Drive 资源 URI

string

结果条目的 ID。使用 overwrite 时，等于现有文件的 item_id（保持不变）。使用 replace、rename 或全新创建时，会签发新的 item_id。

string

实际生效的名称。当 rename 产生了自动后缀时，会与请求中的 name 不同。

{
  "success": true,
  "data": {
    "uri": "drive://items/sc-5c6bf0f82d624a20a6fa4696997bdd46:7d8cf1e93f634b31b5",
    "item_id": "sc-5c6bf0f82d624a20a6fa4696997bdd46:7d8cf1e93f634b31b5",
    "name": "report.pdf"
  }
}

请始终从响应中读取 name。使用默认的 rename 策略时，服务器可能已追加后缀 — 返回的 name 才是您应该展示和存储的名称。

​请求体

​响应

请求体

响应