Queries

Whether the AI chat editor is usable for the ACTIVE org (env key + org toggle + plan gate).

One chat session with its messages (own org only).

Recent chat sessions of the active org, newest first.

Merchant-facing build/redesign skills (for the chat '/' command menu).

Per-user AI client artifact (e.g. the draw-first mockup HTML + version history) — value is an opaque string, null when absent. Scoped to the caller's org+user.

Workspace revert points for a run (or the caller's store), newest-first.

List the current org's API keys (no secrets).

The scope catalog the create form offers.

Resolve the calling key's org + scopes + store(s). Any valid key may call it.

Paginated leads for a store (search by email/name, optional list/status filter).

Marketing lead linked to a commerce customer (customer_id pointer, falling back to email match). Null when the customer has no marketing presence.

Live match count for an ad-hoc condition (segment builder preview).

Paginated, sortable campaigns for a store (optional status filter).

Resolve a campaign by its per-org friendly number.

Poll a reindex run by id for live progress.

The active org's most recent reindex run (to show last result on page load).

Get all debt transactions for an organization

Get customers with outstanding debt

Get customer credit/debt info for POS

Get all loyalty point transactions for an organization

Get loyalty point transactions for a customer

Get expiring points for a customer

Get loyalty point balance for customer

Get points history for customer (simple list, no pagination)

Get all RFM segment rules for organization

Get single RFM segment rule by ID

List wishlist items for the current authed customer OR the supplied anon session_token.

Current vs suggested SPF/DKIM/DMARC DNS records for a sending domain.

Resolve a template by its per-org human-facing number.

REAL store data for preview/test rendering: {contact, store, order{items[]}, cart{items[]}, shipping, coupon, products[]} built from the latest order, live cart, active coupon and newest products. Sections missing from an empty store are omitted — the client falls back to canned examples.

Resolve a product feed to real products for the builder's feed-driven widgets.

Resolve manually-picked product ids to real products for the builder widgets.

Headline email metrics for the period with previous-period comparison + daily trend.

Delivery / bounce / complaint rates, broken down by recipient ISP/domain.

Revenue attributed to campaigns vs flows over the period.

Contact-list growth (new / unsubscribed / bounced) over the period.

Unified email + web event timeline for a lead (newest first).

Email event counts for a store over the last N days (event_type → count).

Admin listing of raw email events, newest first, with optional filters.

Admin listing of custom/web (marketing) events, newest first, with optional filters.

All track events known for a store: standard catalog ∪ org custom definitions ∪ events actually observed in marketing_events.

The roles, their current per-store mapping, and the events available to assign — drives the Mapped Metrics screen.

User-defined conversion metrics for the store.

Compute a conversion metric's current value over the last sinceDays (0 = all time).

All plan definitions (platform admin).

Every shop-owning account + counts/caps/role/status (platform admin).

A single plan by id (platform admin).

Every org with its plan + owner (platform admin, cross-org).

The active org's plan + current usage (any org member).

List product feeds for the active org, optionally scoped to one store.

Generation history (run log) for one feed, newest first.

The embedded default Liquid template for a channel/format — seeds the editor.

Most recent send event for one (node, contact) within a flow (analytics drill-down).

Look up a single recorded flow send event by its send_id within a flow.

Newest-first per-run execution history for a flow (live + test runs).

Public: form render data by public id (active only).

Public: status-agnostic form render config by public id (any status).

List catalog rules (org-scoped, paginated). `store_id` narrows to rules that target that store — matches both unscoped rules (apply to all stores) and rules whose `store_ids` JSONB array contains the given id.

Get one catalog rule.

Get paginated promotions

Get a single promotion

Get all sales rules

Get a single sales rule

Get coupons for a rule

Validate a coupon code

Get coupon statistics for a rule

Resolve every active product block for a storefront position. `product_slug` is the PDP/category anchor (drives same-as matching); `cart_product_ids` anchors cart/checkout blocks. Blocks that resolve to zero products are omitted.

List product blocks (org-scoped, paginated).

Get one product block.

Preview the products a block configuration would match for an anchor product (includes drafts). Used by the admin editor's live preview pane.

Per-block view/click totals over the last `days` (default 30).

Get all registered payment methods.

Get available payment methods for a specific store.

Get available payment methods for a quote. Filters by store availability AND quote-specific conditions (e.g., credit limit for debt).

Verify Stripe credentials configured for a store by calling Account.retrieve(). Returns the account display name on success, or surfaces the Stripe API error so admin can fix bad keys.

Step-by-step payment event log for an order (the Shopify-style payment timeline): intent created → succeeded/failed/canceled → refunds → raw webhooks. Sourced from the append-only payment_transactions ledger.

Store-wide payment event log (admin observability): every ledger row across all orders for a store — intents, succeeded/failed/canceled, refunds, disputes/chargebacks, 3DS challenges, and raw webhooks. Filterable by event type, status, and date range; paginated.

Poll a bulk-apply run for progress.

The org's most recent bulk-apply run (for the admin page on load).

Get current open shift for user

Get shift summary

Get shift history

Get all registered shipping carriers.

Get available shipping carriers for a specific store.

Get available shipping rates for a quote. Calculates rates based on cart contents and delivery address.

List a store's tracking destinations (credentials masked).

A single destination by id.

Paginated server-side delivery log for a destination (newest first).

The canonical-event catalog for the event picker.

The supported-platform catalog for the add-destination form.

Public per-store tracking config for the storefront runtime (no secrets).

List a store's webhooks (secrets masked).

A single webhook by id.

Paginated delivery log for a webhook (newest first).

The supported event-type catalog for the create-form picker.

Get paginated blog posts for admin

Get a single blog post by ID or slug

Get published posts for storefront (public)

Get featured posts for storefront

Get recent posts for storefront

Get all blog categories for a store

Get category tree (hierarchical)

Get a single blog category

Get all blog tags for a store

Get comments for a post

Get comments for moderation. `status` is nullable — when omitted, all statuses are returned (used by the All tab).

Get comment counts for moderation dashboard

Get all collections for a store

Get a single collection by ID or slug

Preview products matching collection conditions (for builder UI)

Get multiple collections by IDs (for PageBuilder widgets)

Get a collection by ID for preview/public (no auth)

Get all active collections for a store (no auth)

Get products from a collection for preview/public (no auth)

Get paginated media for a store

Get a single media item by ID

Get available folders for a store

Get all custom fonts for a store

Get a single font by ID

Get distinct font family names for a store

Get combined CSS for all store fonts

Get combined CSS for all store fonts for SSR preview (no auth)

Get all menus for a store

Get a specific menu by ID

Get a menu by handle

Get menu items for a menu

Get a specific menu item

Get menu by handle for preview/public storefront (no auth)

Get list of menus for a store (no auth)

Browse collections for Resource Browser

Browse products for Resource Browser

Browse pages for Resource Browser

Browse blog categories for Resource Browser

Browse blog posts for Resource Browser

Get all pages for a store

Get a single page by ID

Find a page by type and slug

Get the home page for a store

Get all global sections for a store

Get a specific global section

Get store by slug for public pages (no auth)

Get published page for public storefront (no auth)

Get published global sections for public storefront (no auth)

Get active theme for public storefront (no auth)

Get the currently authenticated customer profile

Public store branding + SEO defaults — populated into Liquid's `shop.*` context. Anonymous read.

Get the active storefront cart for this session. Returns a freshly-created empty quote when there's nothing yet.

Real shipping rates for the session's cart, computed from the store's enabled carriers + selling country. Session-verified (no auth). ShippingRate is defined in shipping.graphql.

Authed customer's order history. Auth required (Bearer token).

Authed customer's saved address book.

Single saved address by ID (must belong to the authed customer).

Placeholder anchor — gqlgen needs at least one stub here when we close the previous extend with `}` early.

Get a single product by slug for public storefront

Search products in a store's catalog with optional filters + facets.

Get a collection by slug for public storefront

Get all active collections for a store (public)

Get a published page by type

Get a published blog post by store slug and post slug

List published blog posts with optional category / tag / pagination filters

List blog tags for the storefront sidebar / filter chips

List blog categories for the storefront navigation

Paginated products inside a published collection with optional filter + facets.

Related products for a PDP — same category / collection, exclude self

Top approved reviews across all products in a store, for the homepage testimonials section. Ordered by rating DESC, then recency DESC.

Resolve a menu by handle for the storefront header / footer

All menus for a store, fully hydrated — the storefront fetches every menu in one round-trip instead of one query per handle

Get order by number for storefront confirmation page

Get all themes for a store

Get a single theme by ID

Get the active theme for a store

Get available preset themes

Get pre-built theme templates (Shopify-style picker). Filterable by industry/style.

Get sections for a theme

Get assets for a theme

List files in a theme, optionally narrowed by path prefix / content type. Set include_inherited=true to also return files inherited from the parent theme (each file's `source` field then tells you which).

Read a single theme file by path. By default returns only files owned by this theme; pass include_inherited=true to fall back to the parent theme when the path is not owned locally.

Storefront-public list of files for the active theme of a store. No auth required. Inheritance is always applied — public callers always see resolved content.

Storefront-public read of a single theme file by path. No auth required. Inheritance is always applied.

Storefront-public single-round-trip read of the entire theme (metadata + resolved file tree + etag). The frontend Liquid renderer consumes this directly.

List the most recent snapshots of a theme (newest first).

Look up a snapshot by id (admin / diff view).

Validate settings_data against the theme's settings_schema.

Public: resolve an opaque preview token into the theme/page it grants access to. Returns null when the token is missing, expired, or revoked. Storefront uses this to swap `?preview_token=…` for an internal theme_id. NO AUTH — the token itself is the credential.

Public: same shape as publicResolvedTheme but selects the theme the preview token grants access to instead of the store's live theme. Returns null on missing/expired/revoked token. Single round-trip: token validation + bundle fetch are atomic so the storefront can't race a token expiry. NO AUTH — the token IS the credential.

Resolve widget template for a store with inheritance

Get the default template for a widget type

Get all widget types that support template customization

List all custom templates for a store

List all templates for a theme