**Version: 202601**

# Upgrade theme

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

Create a new theme upgraded to the latest version from the specified theme, carrying over its configuration; the original theme is left unchanged. Returns the new theme ID.

## Request

**Path Parameters**

- `theme_id` string (required)

  The ID of the theme to upgrade

**application/json**

**Body | Example**

**Body (required)**

- `name` string

  Optional new name for the upgraded theme. Leave empty to keep the current name

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

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `theme_id` string

    The ID of the upgraded theme

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