更新 AI 卡片

PATCH 
/openapi/2026-01/themes/edit-sessions/:oseid/gen-blocks

用新的源码和完整配置更新 AI 卡片。卡片没被使用或只用在一处时直接修改（branched=false）；用在多处时会另建一张新卡片来承载这次修改（branched=true），需要用返回的 settings 替换目标位置上的卡片。

请求

Path参数

oseid string必填

编辑会话 ID

application/json

请求体

请求体必填

contentstring必填

新的 liquid 代码，必须含 schema 标签

settingsobject必填

卡片的完整配置，形态与新建响应的 settings 一致。其中 type（blocks/gen_ 前缀）指明要变更哪张卡片，字段值是商家当前这份配置

示例

json

{
  "content": "string",
  "settings": {}
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

revert_idstring

撤销本次变更的凭据（见 gen-blocks/revert）

branchedboolean

false = 已原地覆盖（引用数 0/1），实例配置未被触碰、无需后续操作；true = 引用数 >= 2，已新开分支承载本次变更——需按返回的 settings 改写目标实例

settingsobject

变更后的完整配置；走新开分支时其 type 是新卡片的 card_type

示例

json

{
  "code": "string",
  "message": "string",
  "data": {
    "revert_id": "string",
    "branched": true,
    "settings": {}
  }
}