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 stringrequired

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

Schema

codestring

error code

messagestring

error message

data object

doc object

File attributes of the card

idstring

Doc id (uuid) of the card file

typestring

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

locationstring

File name, e.g. gen_1a0d523.liquid

hashstring

MD5 of the current content (edit-session view)

contentstring

Card liquid source; only returned when with_content=true

created_atstring

Created at

updated_atstring

Updated at: when the current content was last modified

savedboolean

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

ref_countint32

Number of instance references across the theme

instancesobject

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

Example

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": {}
  }
}