**Version: 202601**

# Update theme global config

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

Partially update the theme's global config within an edit session: pass only the settings to change (one or many). Updates the theme settings by default; pass `section_id` to update a global card such as the header, footer, announcement bar, or cart drawer.

## Request

**Path Parameters**

- `oseid` string (required)

  Edit session ID
- `doc_id` string (required)

  Document (template file) ID

**application/json**

**Body | Example**

**Body (required)**

- `settings` object (required)

  Settings to change — partial, one or many key/value pairs; other settings stay untouched
- `section_id` string

  Target: omit or `skin` = global variables; otherwise a global section's type or stored id — the global singletons (`header`, `footer`, `announcement`, `cart_drawer`) or any member of the header / footer regions. An id that is not in the session returns 400
- `template_name` string

  Render-context template name, default `index`
- `locale` string

  Render locale, default `en_US`

```json
{
  "settings": {},
  "section_id": "string",
  "template_name": "string",
  "locale": "string"
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `section` object

    The stored section after the update (for skin: the changed settings echoed back)
  - `html` string

    Rendered HTML for global cards; empty for skin (no render)

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