更新编辑会话文件

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

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

请求

Path参数

oseid string必填

编辑会话 ID

doc_id string必填

会话内文件的文档 ID

application/json

请求体

请求体必填

config object[]
该文件完整、有序的 section 配置列表。本接口为整文件写入：该列表会覆盖文件当前的 sections，未出现在列表中的 section 将被删除；数组顺序即页面渲染顺序。只想做局部修改请改用批量操作接口
Array [
idint64
section 实例的数字 ID（文件中存储的时间戳式 id）。按名字寻址的全局卡片（header、footer、announcement、cart_drawer）无法用本字段表达
settingsobject
section 设置对象
with_hook_setboolean
只读的渲染标记，由渲染服务回传；在请求里传该字段不产生任何效果。默认 false
]
global_config object

全局配置

libsstring

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

layoutstring

布局名，如 theme

示例

json

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

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

template_dataobject

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

示例

json

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