**版本：202601**

# 更新编辑会话文件

**PATCH** `/openapi/2026-01/themes/edit-sessions/:oseid/files/:doc_id`

用传入的卡片配置整体覆盖编辑会话中的模板文件，列表里没有的卡片会被删除；只改局部请用「批量执行编辑操作」。

## 请求

**Path参数**

- `oseid` string (required)

  编辑会话 ID
- `doc_id` string (required)

  会话内文件的文档 ID

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `config` object[]

  该文件完整、有序的 section 配置列表。本接口为整文件写入：该列表会**覆盖**文件当前的 sections，未出现在列表中的 section 将被删除；数组顺序即页面渲染顺序。只想做局部修改请改用批量操作接口

  *   Array \[

  - `id` int64

    section 实例的数字 ID（文件中存储的时间戳式 id）。按名字寻址的全局卡片（`header`、`footer`、`announcement`、`cart_drawer`）无法用本字段表达
  - `settings` object

    section 设置对象
  - `with_hook_set` boolean

    只读的渲染标记，由渲染服务回传；在请求里传该字段不产生任何效果。默认 false
  *   \]
- `global_config` object

  全局配置

  - `libs` string

    主题级 libs（库）配置。整文件写入接口并不消费该字段，只读取每个 config 项的 id 与 settings 以及 layout，此处传 `""` 即可
- `layout` string

  布局名，如 theme

```json
{
  "config": [
    {
      "id": 0,
      "settings": {},
      "with_hook_set": true
    }
  ],
  "global_config": {
    "libs": "string"
  },
  "layout": "string"
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `template_data` object

    更新后的模板数据（`{sections, content_for_page}`）

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "template_data": {}
  }
}
```