**版本：202601**

# 更新 AI 卡片

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

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

## 请求

**Path参数**

- `oseid` string (required)

  编辑会话 ID

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `content` string (required)

  新的 liquid 代码，必须含 schema 标签
- `settings` object (required)

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

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

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `revert_id` string

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

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

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

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