**版本：202601**

# 启用应用嵌入

**POST** `/openapi/2026-01/themes/edit-sessions/:oseid/apps/enable`

在编辑会话中启用指定的 app-embed 或 script tag。

## 请求

**Path参数**

- `oseid` string (required)

  编辑会话 ID

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `doc_id` string

  包含 skin section 的文档（模板文件）ID。选填；为空时服务端自动解析 index.liquid
- `theme_id` string (required)

  要修改应用开关的主题 ID；同时用于解析默认文档与渲染上下文
- `category` string

  类别：`app_embeds` 或 `script_tags`。选填；仅在 `block_id` 不唯一时用于消歧
- `app_key` string

  应用分组键。选填；为空时服务端按 `block_id` 全搜分组
- `block_id` string (required)

  块标识：`app_embeds` 用 `type` 字段，`script_tags` 用 `id` 字段
- `template_name` string

  渲染上下文模板名；默认 `index`
- `locale` string

  渲染语言；默认 en\_US

```json
{
  "doc_id": "string",
  "theme_id": "string",
  "category": "string",
  "app_key": "string",
  "block_id": "string",
  "template_name": "string",
  "locale": "string"
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `` object

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