创建节点输出版本

为指定节点输出内容创建版本。

POST https://api.moi.matrixorigin.cn/v5/lineage/artifacts/{artifact_id}/nodes/{node_id}/blocks/{block_id}/revisions

调用前准备

准备有目标工作区访问权限的个人访问令牌和目标工作区 ID。

请求体

输入示例

curl -X POST "https://api.moi.matrixorigin.cn/v5/lineage/artifacts/$ARTIFACT_ID/nodes/$NODE_ID/blocks/$BLOCK_ID/revisions" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "use_current_effective": true,
    "revision_content_payload": "修订后的内容"
  }'

参数说明

字段	类型	是否必填	说明
artifact_id	string	必填	工作流处理结果 ID。
node_id	string	必填	处理节点 ID。
block_id	string	必填	输出内容 ID。
base_revision_id	string	否	新版本基于的输出版本 ID。
use_original	boolean	否	使用原始内容作为基础。
use_current_effective	boolean	否	使用当前生效版本作为基础。
expected_effective_set_version	integer	否	当前生效版本集版本号。
expected_base_content_hash	string	否	用于校验基础内容是否已变化的哈希值。
revision_content_ref	string	否	新版本内容的引用。
revision_content_hash	string	否	新版本内容的哈希值。
revision_content_payload	string	否	新版本的完整内容。
patch_json	string	否	基于基础内容生成新版本的 JSON 补丁。

成功响应

创建成功时返回该节点输出内容的新版本。保存返回的新输出版本 ID，后续设置生效版本时需要使用。

响应字段如下。

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "artifact_id": "art-001",
    "node_id": "node-001",
    "block_id": "block-001",
    "revision": {
      "revision_id": "rev-002",
      "status": "active"
    }
  }
}

字段说明

字段	类型	是否必填	说明
code	string	否	成功时为 OK。
msg	string	否	成功时为 OK。
data.artifact_id	string	否	处理结果 ID。
data.node_id	string	否	节点 ID。
data.block_id	string	否	输出内容 ID。
data.revision	object	否	新创建的输出版本。
revision	object	否	新输出版本。

下面表格展开响应示例中 data 下的 revision 对象；每一行是该对象的一个字段。

字段	类型	是否必填	说明
revision_id	string	否	新输出版本 ID。
status	string	否	新输出版本的状态。

错误响应

响应示例

{
  "code": "ErrParamInvalid",
  "msg": "请求参数无效",
  "data": null
}

字段说明

字段	类型	是否必填	说明
code	string	否	错误代码。
msg	string	否	可读错误信息。
data	null	否	错误响应中为 null。

最后更新于 2026 年 9 月 11 日