**版本：202601**

# 创建主题文件

**POST** `/openapi/2026-01/themes/:theme_id/doc`

在指定主题中创建新文件。

## 请求

**Path参数**

- `theme_id` string (required)

  主题 ID

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `doc` object (required)

  要创建的文件，包含文件类型、路径和内容

  - `type` string (required)

    文件类型：`layout`、`templates`、`sections`、`snippets`、`assets`、`config`、`locales`、`blocks`
  - `location` string (required)

    位置信息
  - `content` string

    内容。不传时创建空文件

```json
{
  "doc": {
    "type": "string",
    "location": "string",
    "content": "string"
  }
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `` object

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