**Version: 202601**

# Enable app embed

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

Enable a specific app-embed block or script tag within an edit session.

## Request

**Path Parameters**

- `oseid` string (required)

  Edit session ID

**application/json**

**Body | Example**

**Body (required)**

- `doc_id` string

  Document (template file) ID containing the skin section. Optional; empty -> server resolves index.liquid
- `theme_id` string (required)

  Theme ID whose app switches are updated; also resolves the default document and the rendering context
- `category` string

  Category: `app_embeds` or `script_tags`. Optional; only used to disambiguate when `block_id` is not unique
- `app_key` string

  App grouping key. Optional; empty -> server searches all groups by `block_id`
- `block_id` string (required)

  Block identifier: `type` field for `app_embeds`, `id` field for `script_tags`
- `template_name` string

  Render-context template name; defaults to `index`
- `locale` string

  Rendering locale; defaults to en\_US

```json
{
  "doc_id": "string",
  "theme_id": "string",
  "category": "string",
  "app_key": "string",
  "block_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

  - `` object

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