**Version: 202601**

# Get AI card details

**GET** `/openapi/2026-01/themes/edit-sessions/:oseid/gen-blocks`

Get an AI card's file info and its usage in the current session (whether it is saved, how many times it is used, etc.); pass `with_content=true` to include the card's source code.

## Request

**Path Parameters**

- `oseid` string (required)

  Edit session ID

**Query Parameters**

- `type` string

  The `card_type` (`blocks/` + file name without extension), e.g. `blocks/gen_1a0d523`
- `with_content` boolean

  When true, the response additionally carries the card source in `doc.content`

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `doc` object

    File attributes of the card

    - `id` string

      Doc id (uuid) of the card file
    - `type` string

      File directory, always `blocks`; `card_type` = `type` + `/` + `location` without extension
    - `location` string

      File name, e.g. `gen_1a0d523.liquid`
    - `hash` string

      MD5 of the current content (edit-session view)
    - `content` string

      Card liquid source; only returned when `with_content=true`
    - `created_at` string

      Created at
    - `updated_at` string

      Updated at: when the current content was last modified
  - `saved` boolean

    Whether the card is already in the draft (matched by location, content not compared)
  - `ref_count` int32

    Number of instance references across the theme
  - `instances` object

    Reference detail keyed by container: `{ <container location without extension>: [paths...] }`. Paths use the arrangement API's target syntax and always land on a blocks-array index, e.g. `1787800762db788e94.blocks.0` or `sections.1787800762db788e94.blocks.0`

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "doc": {
      "id": "string",
      "type": "string",
      "location": "string",
      "hash": "string",
      "content": "string",
      "created_at": "string",
      "updated_at": "string"
    },
    "saved": true,
    "ref_count": 0,
    "instances": {}
  }
}
```