**版本：202601**

# 升级主题

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

基于指定主题生成一个升级到最新版本的新主题，并沿用原主题的配置，原主题保持不变；返回新主题 ID。

## 请求

**Path参数**

- `theme_id` string (required)

  要升级的主题 ID

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `name` string

  可选，升级后主题的新名称；不传则保留原名称

```json
{
  "name": "string"
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `theme_id` string

    升级后主题的 ID

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