Queek docs
Storefront endpoint reference

Metaobjects

GET
/store/metaobject-definitions

The store’s storefront-visible metaobject definitions: the custom content types a theme reads before rendering one.

Authorization

clientKey
X-Client-Key<token>

The connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

In: header

Header Parameters

X-Client-Key*string

Your connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

X-Request-Id?string

Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/store/metaobject-definitions" \  -H "X-Client-Key: {{clientKey}}"
{  "status": "success",  "message": "Metaobject definitions",  "data": [    {      "type": "lookbook",      "name": "Lookbook",      "display_field": "title",      "has_pages": true,      "fields": [        {          "key": "title",          "name": "Title",          "type": "single_line_text"        },        {          "key": "season",          "name": "Season",          "type": "single_line_text"        },        {          "key": "story",          "name": "Story",          "type": "multi_line_text"        }      ]    }  ]}
GET
/store/metaobjects/{type}

Active entries of one storefront-visible definition, ordered by display name. Anything else 404s.

Authorization

clientKey
X-Client-Key<token>

The connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

In: header

Path Parameters

type*string

The metaobject type handle, as listed by GET /store/metaobject-definitions (type). A type the store does not expose to the storefront answers 404.

Query Parameters

starting_after?string

Keyset cursor: pass the previous page next_cursor. Walk while has_more is true; a stale, tampered, cross-list or filter-changed cursor answers 422 validation_failed with the failure on starting_after. Never combine with page.

limit?integer

Items per read (alias of per_page, clamps 1..50). page mode caps at page 50 (a deeper page answers 422 validation_failed on page); walk the cursor past that.

Header Parameters

X-Client-Key*string

Your connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

X-Request-Id?string

Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/store/metaobjects/lookbook?limit=15" \  -H "X-Client-Key: {{clientKey}}"
{  "status": "success",  "message": "Metaobjects retrieved",  "data": [    {      "p_id": 1301,      "type": "lookbook",      "handle": "winter-26",      "display_name": "Winter ’26",      "status": "active",      "fields": {        "title": "Winter ’26",        "season": "Winter 2026",        "story": "Dusty-rose layers for December travel."      }    },    {      "p_id": 1302,      "type": "lookbook",      "handle": "party-season",      "display_name": "Party Season",      "status": "active",      "fields": {        "title": "Party Season",        "season": "Party season",        "story": "Statement prints for Saturday parties."      }    }  ],  "meta": {    "definition": {      "type": "lookbook",      "name": "Lookbook",      "has_pages": true    }  },  "has_more": false,  "next_cursor": null}
GET
/store/metaobjects/{type}/{handle}

One storefront-visible metaobject entry by type and handle.

Authorization

clientKey
X-Client-Key<token>

The connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

In: header

Path Parameters

type*string

The metaobject type handle, as listed by GET /store/metaobject-definitions (type). A type the store does not expose to the storefront answers 404.

handle*string

Handle of the entry, as returned for that type (handle). Only active entries are served.

Header Parameters

X-Client-Key*string

Your connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

X-Request-Id?string

Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/store/metaobjects/lookbook/winter-26" \  -H "X-Client-Key: {{clientKey}}"
{  "status": "success",  "message": "Metaobject entry",  "data": {    "p_id": 1301,    "type": "lookbook",    "handle": "winter-26",    "display_name": "Winter ’26",    "status": "active",    "fields": {      "title": "Winter ’26",      "season": "Winter 2026",      "story": "Dusty-rose layers for December travel."    }  },  "meta": {    "definition": {      "type": "lookbook",      "name": "Lookbook",      "has_pages": true    }  }}