DKShop Admin API

Version 1.0.0 · 186 paths · 277 operations

Authenticate with a store API key: Authorization: Bearer dk_sk_…. Create one in the dashboard under Settings → API keys. The key names its own store, so no store header is sent.

Every operation needs the scope in its row, and the ones marked admin need a key of that role. The full machine-readable description, with request and response shapes, is at openapi.json.

API keys

Managing API keys. Deliberately unreachable with an API key.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/api-keysList API keysapi_keys APIKeyView[]api-keys:readadmin
POST /api/v1/store/api-keysCreate an API keyapi_key APIKeyViewapi-keys:writeadmin
GET /api/v1/store/api-keys/scopesList the grantable API scopesactions string[]
resources ScopeResourceView[]
api-keys:readadmin
DELETE /api/v1/store/api-keys/{id}Revoke an API keyapi_key APIKeyViewapi-keys:writeadmin

Abandoned carts and checkouts

Baskets and checkouts that did not become an order.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/abandoned-cartsList abandoned cartsabandoned AbandonedCartRowView[]
stats AbandonmentStatsView
abandoned:readany
GET /api/v1/store/abandoned-checkoutsList abandoned checkoutsabandoned AbandonedCheckoutRowView[]
stats AbandonmentStatsView
abandoned:readany
GET /api/v1/store/abandoned-checkouts/{token}Get an abandoned checkoutcheckout AbandonedcartDetailabandoned:readany

Analytics

Sales, conversion and post-purchase reporting.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/analyticsGet the analytics overviewanalytics AnalyticsOverviewanalytics:readany
GET /api/v1/store/analytics/upsellGet post-purchase upsell totalsupsell AnalyticsUpsellReportanalytics:readany
GET /api/v1/store/analytics/upsell/reportGet the detailed post-purchase upsell reportreport AnalyticsUpsellDeepReportanalytics:readany

Audit log

Who changed what, including which API key did it.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/audit-logsList audit loglogs AuditLog[]audit-logs:readadmin

Blog

Blog articles.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/articlesList blog articlesarticles ArticleView[]blog:readany
POST /api/v1/store/articlesCreate a blog articlearticle ArticleViewblog:writeadmin
GET /api/v1/store/articles/{id}Get a blog articlearticle ArticleViewblog:readany
PUT /api/v1/store/articles/{id}Update a blog articlearticle ArticleViewblog:writeadmin
DELETE /api/v1/store/articles/{id}Delete a blog articleblog:writeadmin

Checkout and post-purchase

Checkout zones and pages, post-purchase upsell funnels, and tipping.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/checkout-pagesList checkout pagespages CheckoutPageListView[]checkout:readany
POST /api/v1/store/checkout-pagesCreate a checkout pagepage CheckoutPageViewcheckout:writeadmin
GET /api/v1/store/checkout-pages/{id}Get a checkout pagepage CheckoutPageViewcheckout:readany
PUT /api/v1/store/checkout-pages/{id}Update a checkout pagepage CheckoutPageViewcheckout:writeadmin
DELETE /api/v1/store/checkout-pages/{id}Delete a checkout pagecheckout:writeadmin
PUT /api/v1/store/checkout-pages/{id}/defaultSet defaultspage CheckoutPageViewcheckout:writeadmin
PUT /api/v1/store/checkout-pages/{id}/sectionsSet sectionspage CheckoutPageViewcheckout:writeadmin
GET /api/v1/store/checkout-zonesList checkout zoneszones CheckoutZoneView[]checkout:readany
POST /api/v1/store/checkout-zonesCreate a checkout zonezone CheckoutZoneViewcheckout:writeadmin
GET /api/v1/store/checkout-zones/{id}Get a checkout zonezone CheckoutZoneViewcheckout:readany
PUT /api/v1/store/checkout-zones/{id}Update a checkout zonezone CheckoutZoneViewcheckout:writeadmin
DELETE /api/v1/store/checkout-zones/{id}Delete a checkout zonecheckout:writeadmin
GET /api/v1/store/pp15Get a pp15config FeatureflagsPP15Config
platform PP15PlatformView
checkout:readany
PUT /api/v1/store/pp15Set pp15scheckout:writeadmin
GET /api/v1/store/tippingGet a tippingtipping TippingConfigcheckout:readany
PUT /api/v1/store/tippingSet tippingstipping TippingConfigcheckout:writeadmin
GET /api/v1/store/upsell-funnelsList post-purchase funnelsfunnels FunnelSummaryView[]checkout:readany
POST /api/v1/store/upsell-funnelsCreate a post-purchase funnelfunnel FunnelViewcheckout:writeadmin
GET /api/v1/store/upsell-funnels/{id}Get a post-purchase funnelfunnel FunnelViewcheckout:readany
PUT /api/v1/store/upsell-funnels/{id}Update a post-purchase funnelfunnel FunnelViewcheckout:writeadmin
DELETE /api/v1/store/upsell-funnels/{id}Delete a post-purchase funnelcheckout:writeadmin
POST /api/v1/store/upsell-funnels/{id}/checkout-pageEnsure a funnel has a checkout pagepage CheckoutPageRefViewcheckout:writeadmin
PUT /api/v1/store/upsell-funnels/{id}/pp15Override the store's handling surcharge for this funnel (null inherits it again)checkout:writeadmin
PUT /api/v1/store/upsell-funnels/{id}/steps/{stepId}/upsell-pageSet one step's own upsell designcheckout:writeadmin
DELETE /api/v1/store/upsell-funnels/{id}/steps/{stepId}/upsell-pageClear a step's own upsell design so it inherits the funnel'scheckout:writeadmin
PUT /api/v1/store/upsell-funnels/{id}/tippingOverride the store's tipping rule for this funnel (null inherits it again)checkout:writeadmin
PUT /api/v1/store/upsell-funnels/{id}/upsell-pageSet upsell pagescheckout:writeadmin

Collections

Manual and smart groupings of products, and their membership.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/collectionsList collectionscollections CollectionListView[]collections:readany
POST /api/v1/store/collectionsCreate a collectioncollection CollectionViewcollections:writeadmin
POST /api/v1/store/collections/bulk-deleteDelete several collectionsdeleted integer
ids any
collections:writeadmin
GET /api/v1/store/collections/handle-availableCheck whether a collection handle is freeavailable booleancollections:readany
GET /api/v1/store/collections/optionsList collections as id and title, for pickerscollections CatalogCollectionOption[]collections:readany
POST /api/v1/store/collections/previewPreview which products a smart-collection rule matchescollection_type any
created_at any
description any
disjunctive any
handle any
id any
image_src any
position any
price_cents any
products CollectionMemberView[]
published any
rules any
seo any
sort_order any
title any
updated_at any
collections:writeadmin
GET /api/v1/store/collections/{id}Get a collectioncollection CollectionViewcollections:readany
PUT /api/v1/store/collections/{id}Update a collectioncollection CollectionViewcollections:writeadmin
DELETE /api/v1/store/collections/{id}Delete a collectioncollections:writeadmin
GET /api/v1/store/collections/{id}/productsList the products in a collectionproducts CollectionMemberView[]collections:readany
POST /api/v1/store/collections/{id}/productsAdd a product to a collectioncollections:writeadmin
PUT /api/v1/store/collections/{id}/products/reorderReorder the products in a collectioncollections:writeadmin
DELETE /api/v1/store/collections/{id}/products/{pid}Remove a product from a collectioncollections:writeadmin

Custom domains

Domains connected to this storefront.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/domainsList custom domainsdomains DomainView[]domains:readany
POST /api/v1/store/domainsConnect a custom domaindomain DomainViewdomains:writeadmin
DELETE /api/v1/store/domains/{id}Delete a custom domaindomains:writeadmin
POST /api/v1/store/domains/{id}/primarySet primarysdomains:writeadmin
POST /api/v1/store/domains/{id}/verifyRe-check a custom domain nowdomain DomainViewdomains:writeadmin

Discounts

Discount codes and automatic discounts.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/discountsList discountsdiscounts DiscountView[]discounts:readany
POST /api/v1/store/discountsCreate a discountdiscount DiscountViewdiscounts:writeadmin
GET /api/v1/store/discounts/{id}Get a discountdiscount DiscountDetailViewdiscounts:readany
PUT /api/v1/store/discounts/{id}Update a discountdiscount DiscountViewdiscounts:writeadmin
DELETE /api/v1/store/discounts/{id}Delete a discountdiscounts:writeadmin

Draft orders

Orders a seller builds by hand, before they are paid.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/draft-ordersList draft ordersdraft_orders DraftOrderView[]draft-orders:readany
POST /api/v1/store/draft-ordersCreate a draft orderdraft_order DraftOrderViewdraft-orders:writeadmin
GET /api/v1/store/draft-orders/{id}Get a draft orderdraft_order DraftOrderViewdraft-orders:readany
PUT /api/v1/store/draft-orders/{id}/contactSet contactsdraft_order DraftOrderViewdraft-orders:writeadmin
POST /api/v1/store/draft-orders/{id}/line-itemsAdd a line item to a draft orderdraft_order DraftOrderViewdraft-orders:writeadmin
DELETE /api/v1/store/draft-orders/{id}/line-items/{lineId}Remove a line item from a draft orderdraft_order DraftOrderViewdraft-orders:writeadmin
POST /api/v1/store/draft-orders/{id}/mark-as-paidMark a draft order as paidcustom any
id any
line_total_cents any
order_id integer
order_number any
order_number_display any
price_cents any
quantity any
sku any
title any
variant_id any
variant_title any
draft-orders:writeadmin

Email settings

Per-store SMTP.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/emailGet an emailemail StoremailConfigemail:readany
PUT /api/v1/store/emailSet emailsemail StoremailConfigemail:writeadmin
POST /api/v1/store/email/testSend a test emailemail:writeadmin

Form submissions

Contact-form, newsletter and popup submissions.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/form-submissionsList form submissionscounts any
submissions FormSubmissionView[]
forms:readany
GET /api/v1/store/form-submissions/exportExport form submissions as CSVforms:readany
DELETE /api/v1/store/form-submissions/{id}Delete a form submissionforms:writeadmin
PUT /api/v1/store/form-submissions/{id}/readMark a form submission as readsubmission FormSubmissionViewforms:writeadmin

Fulfillments

Shipments against an order, with tracking.

EndpointWhat it doesReturnsScopeRole
POST /api/v1/store/fulfillments/{id}/cancelCancel a fulfillmentfulfillment_status stringfulfillments:writeadmin

Marketing and tracking

Marketing pixels, conversion APIs, Klaviyo and abandonment recovery.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/klaviyoGet a klaviyoklaviyo KlaviyoViewmarketing:readany
PUT /api/v1/store/klaviyoSet klaviyosklaviyo KlaviyoViewmarketing:writeadmin
GET /api/v1/store/klaviyo/listsGet a listlists KlaviyoListDTO[]
next_cursor any
marketing:readany
POST /api/v1/store/klaviyo/testTest the Klaviyo connectionaccount KlaviyoAccountViewmarketing:writeadmin
GET /api/v1/store/recovery-settingsGet a recovery settingrecovery AbandonedcartPolicymarketing:readany
PUT /api/v1/store/recovery-settingsSet recovery settingsrecovery AbandonedcartPolicymarketing:writeadmin
GET /api/v1/store/trackingGet a trackingtracking TrackingConfigmarketing:readany
PUT /api/v1/store/trackingSet trackingstracking TrackingConfigmarketing:writeadmin
GET /api/v1/store/tracking/axon-capiGet an axon capiaxon_capi TrackingAxonCAPIViewmarketing:readany
PUT /api/v1/store/tracking/axon-capiSet axon capisaxon_capi TrackingAxonCAPIViewmarketing:writeadmin
GET /api/v1/store/tracking/capiGet a capicapi TrackingCAPIViewmarketing:readany
PUT /api/v1/store/tracking/capiSet capiscapi TrackingCAPIViewmarketing:writeadmin

Media uploads

Presigned uploads for product and theme imagery.

EndpointWhat it doesReturnsScopeRole
POST /api/v1/store/uploads/finalizeFinalize an uploadfilename any
height any
src string
thumbhash any
width any
media:writeadmin
POST /api/v1/store/uploads/requestRequest a presigned upload URLheaders any
key any
max_bytes any
method any
upload_url string
media:writeadmin

Orders

Placed orders, their line items, refunds, cancellation and export.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/ordersList ordersorders OrderSummaryView[]orders:readany
GET /api/v1/store/orders/awaiting-captureList payments authorized but not yet capturedawaiting AwaitingCaptureView[]orders:readany
GET /api/v1/store/orders/exportExport orders as CSVorders:readadmin
GET /api/v1/store/orders/{id}Get an orderorder OrderDetailVieworders:readany
PUT /api/v1/store/orders/{id}Update an ordernote string
tags any
orders:writeadmin
POST /api/v1/store/orders/{id}/archiveArchive an orderorder_status stringorders:writeadmin
POST /api/v1/store/orders/{id}/cancelCancel an orderorder_status stringorders:writeadmin
GET /api/v1/store/orders/{id}/fulfillmentsList fulfillmentsfulfilled FulfilledQuantityView[]
fulfillments FulfillmentView[]
orders:readany
POST /api/v1/store/orders/{id}/fulfillmentsCreate a fulfillmentfulfillment FulfillmentView
fulfillment_status any
orders:writeadmin
POST /api/v1/store/orders/{id}/refundRefund an orderrefund RefundVieworders:writeadmin
GET /api/v1/store/orders/{id}/rendersList rendersrenders RenderView[]orders:readany

Pages

Standalone content pages.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/pagesList pagespages PageView[]pages:readany
POST /api/v1/store/pagesCreate a pagepage PageViewpages:writeadmin
GET /api/v1/store/pages/{id}Get a pagepage PageViewpages:readany
PUT /api/v1/store/pages/{id}Update a pagepage PageViewpages:writeadmin
DELETE /api/v1/store/pages/{id}Delete a pagepages:writeadmin

Payment gateways

Connected gateways. Reading is open to API keys; changing them is not.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/payment-providersList payment gatewaysproviders PaymentProviderView[]payments:readany
POST /api/v1/store/payment-providersConnect a payment gatewayprovider PaymentProviderViewpayments:writeadmin
POST /api/v1/store/payment-providers/testTest payment gateway credentialsvalid booleanpayments:writeadmin
PUT /api/v1/store/payment-providers/{id}Update a payment gatewayprovider PaymentProviderViewpayments:writeadmin
DELETE /api/v1/store/payment-providers/{id}Delete a payment gatewaypayments:writeadmin
PUT /api/v1/store/payment-providers/{id}/card-fieldsSet card fieldsprovider PaymentProviderViewpayments:writeadmin
PUT /api/v1/store/payment-providers/{id}/enabledSet enabledspayments:writeadmin
POST /api/v1/store/payment-providers/{id}/wallet-domainsRegister this store's domains for wallet paymentsprovider PaymentProviderView
results WalletRegistrationView[]
payments:writeadmin

Plan and billing

What this store pays the platform. Reading is open to API keys; changing it is not.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/billingGet this store's plan and accrued feesaccrued any
cards any
collection_enabled any
invoices any
plan any
subscription BillingSubscriptionDTO
billing:readany
PUT /api/v1/store/billing/cancelSet cancelssubscription BillingSubscriptionDTObilling:writeadmin
POST /api/v1/store/billing/cardSave a billing cardcard BillingCardDTObilling:writeadmin
POST /api/v1/store/billing/card/setupStart saving a billing cardclient_secret string
publishable_key any
billing:writeadmin
DELETE /api/v1/store/billing/card/{id}Delete a billing cardbilling:writeadmin
GET /api/v1/store/billing/invoicesList billing invoicesinvoices BillingInvoiceDTO[]
page any
page_size any
billing:readany
GET /api/v1/store/billing/invoices/{id}Get a billing invoicecharges any
invoice BillingInvoiceDTO
lines any
billing:readany
PUT /api/v1/store/billing/planChange this store's billing plansubscription BillingSubscriptionDTObilling:writeadmin
GET /api/v1/store/billing/plansList the available billing plansplans BillingPlanDTO[]billing:readany

Product customizer

Personalisation: designs, option sets, product bases and the renders they produce.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/customizer/bindings/{productId}List a product's customizer bindingsbindings CzProductBindingView[]customizer:readany
PUT /api/v1/store/customizer/bindings/{productId}Bind a customizer template to a product, optionally scoped to one option valuebinding CzProductBindingViewcustomizer:writeadmin
DELETE /api/v1/store/customizer/bindings/{productId}Delete every binding on a productcustomizer:writeadmin
DELETE /api/v1/store/customizer/bindings/{productId}/{bindingId}Delete one of a product's bindingscustomizer:writeadmin
GET /api/v1/store/customizer/designsList designsdesigns CzDesignView[]customizer:readany
POST /api/v1/store/customizer/designsCreate a designdesign CzDesignViewcustomizer:writeadmin
GET /api/v1/store/customizer/designs/{id}Get a designdesign CzDesignViewcustomizer:readany
PUT /api/v1/store/customizer/designs/{id}Update a designdesign CzDesignViewcustomizer:writeadmin
DELETE /api/v1/store/customizer/designs/{id}Delete a designcustomizer:writeadmin
PUT /api/v1/store/customizer/designs/{id}/element-orderRe-stack a design's elements in one request — ids in paint order, position assigns z_indexcustomizer:writeadmin
GET /api/v1/store/customizer/designs/{id}/elementsList design elementselements CzElementView[]customizer:readany
POST /api/v1/store/customizer/designs/{id}/elementsCreate a design elementelement CzElementViewcustomizer:writeadmin
GET /api/v1/store/customizer/designs/{id}/studioOne read for the design studio: a design, its elements with reference counts, and every product base it is placed onstudio CzStudioViewcustomizer:readany
PUT /api/v1/store/customizer/elements/{id}Update a design elementelement CzElementViewcustomizer:writeadmin
DELETE /api/v1/store/customizer/elements/{id}Delete a design elementcustomizer:writeadmin
GET /api/v1/store/customizer/librariesList librarieslibraries CzLibraryView[]customizer:readany
POST /api/v1/store/customizer/librariesCreate a librarylibrary CzLibraryViewcustomizer:writeadmin
PUT /api/v1/store/customizer/libraries/{id}Rename a librarylibrary CzLibraryViewcustomizer:writeadmin
DELETE /api/v1/store/customizer/libraries/{id}Delete a librarycustomizer:writeadmin
GET /api/v1/store/customizer/libraries/{id}/itemsList itemsitems CzLibraryItemView[]customizer:readany
POST /api/v1/store/customizer/libraries/{id}/itemsCreate an itemitem CzLibraryItemViewcustomizer:writeadmin
PUT /api/v1/store/customizer/libraries/{id}/itemsPut an artwork at a positionitem CzLibraryItemViewcustomizer:writeadmin
GET /api/v1/store/customizer/library-cataloguesList artwork catalogues, with hole countscatalogues CzLibraryCatalogueView[]customizer:readany
DELETE /api/v1/store/customizer/library-items/{id}Delete a library itemcustomizer:writeadmin
PUT /api/v1/store/customizer/mockups/{id}Rename a mockup, move it, or replace its photo (a differently sized photo rescales its print areas)mockup CzMockupView
print_areas CzPrintAreaView[]
customizer:writeadmin
DELETE /api/v1/store/customizer/mockups/{id}Delete a mockupcustomizer:writeadmin
GET /api/v1/store/customizer/mockups/{id}/print-areasList print areasprint_areas CzPrintAreaView[]customizer:readany
POST /api/v1/store/customizer/mockups/{id}/print-areasCreate a print areaprint_area CzPrintAreaViewcustomizer:writeadmin
GET /api/v1/store/customizer/option-setsList option setsoption_sets CzOptionSetView[]customizer:readany
POST /api/v1/store/customizer/option-setsCreate an option setoption_set CzOptionSetViewcustomizer:writeadmin
GET /api/v1/store/customizer/option-sets/{id}Get an option setoption_set CzOptionSetViewcustomizer:readany
PUT /api/v1/store/customizer/option-sets/{id}Update an option setoption_set CzOptionSetViewcustomizer:writeadmin
DELETE /api/v1/store/customizer/option-sets/{id}Delete an option setcustomizer:writeadmin
PUT /api/v1/store/customizer/option-sets/{id}/option-orderRe-order an option set's options (whole list, position assigns the order)customizer:writeadmin
GET /api/v1/store/customizer/option-sets/{id}/optionsList optionsoptions CzOptionView[]customizer:readany
POST /api/v1/store/customizer/option-sets/{id}/optionsCreate an optionoption CzOptionViewcustomizer:writeadmin
PUT /api/v1/store/customizer/option-values/{id}Update an option valuevalue CzOptionValueViewcustomizer:writeadmin
DELETE /api/v1/store/customizer/option-values/{id}Delete an option valuecustomizer:writeadmin
PUT /api/v1/store/customizer/options/{id}Update an optionoption CzOptionViewcustomizer:writeadmin
DELETE /api/v1/store/customizer/options/{id}Delete an optioncustomizer:writeadmin
PUT /api/v1/store/customizer/options/{id}/value-orderRe-order an option's values (whole list, position assigns the order)customizer:writeadmin
GET /api/v1/store/customizer/options/{id}/valuesList valuesvalues CzOptionValueView[]customizer:readany
POST /api/v1/store/customizer/options/{id}/valuesCreate a valuevalue CzOptionValueViewcustomizer:writeadmin
PUT /api/v1/store/customizer/options/{id}/valuesReplace an option's values in bulk (upsert by value slug; deletes what it does not name only when prune is set)result CzReplaceOptionValuesViewcustomizer:writeadmin
PUT /api/v1/store/customizer/print-areas/{id}Update a print areaprint_area CzPrintAreaViewcustomizer:writeadmin
DELETE /api/v1/store/customizer/print-areas/{id}Delete a print areacustomizer:writeadmin
GET /api/v1/store/customizer/product-basesList product basesproduct_bases CzProductBaseView[]customizer:readany
POST /api/v1/store/customizer/product-basesCreate a product baseproduct_base CzProductBaseViewcustomizer:writeadmin
GET /api/v1/store/customizer/product-bases/{id}Get a product baseproduct_base CzProductBaseViewcustomizer:readany
PUT /api/v1/store/customizer/product-bases/{id}Update a product baseproduct_base CzProductBaseViewcustomizer:writeadmin
DELETE /api/v1/store/customizer/product-bases/{id}Delete a product basecustomizer:writeadmin
GET /api/v1/store/customizer/product-bases/{id}/mockupsList mockupsmockups CzMockupView[]customizer:readany
POST /api/v1/store/customizer/product-bases/{id}/mockupsCreate a mockupmockup CzMockupViewcustomizer:writeadmin
PUT /api/v1/store/customizer/quantity-tiers/{id}Update a quantity tierquantity_tier CzQuantityTierViewcustomizer:writeadmin
DELETE /api/v1/store/customizer/quantity-tiers/{id}Delete a quantity tiercustomizer:writeadmin
GET /api/v1/store/customizer/statusGet the product customizer's status for this storeplatform_enabled booleancustomizer:readany
GET /api/v1/store/customizer/templatesList customizer templatestemplates CzTemplateView[]customizer:readany
POST /api/v1/store/customizer/templatesCreate a customizer templatetemplate CzTemplateViewcustomizer:writeadmin
GET /api/v1/store/customizer/templates/{id}Get a customizer templatetemplate CzTemplateViewcustomizer:readany
PUT /api/v1/store/customizer/templates/{id}Update a customizer templatetemplate CzTemplateViewcustomizer:writeadmin
DELETE /api/v1/store/customizer/templates/{id}Delete a customizer templatecustomizer:writeadmin
GET /api/v1/store/customizer/templates/{id}/previewOne read for the personalization preview: the design, the product photo it prints onto, and one binding's controls with artwork resolved to that binding's finishpreview CzTemplatePreviewViewcustomizer:readany
GET /api/v1/store/customizer/templates/{id}/quantity-tiersList quantity tiersquantity_tiers CzQuantityTierView[]customizer:readany
POST /api/v1/store/customizer/templates/{id}/quantity-tiersCreate a quantity tierquantity_tier CzQuantityTierViewcustomizer:writeadmin

Product reviews

Reviews, moderation, replies and CSV import/export.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/reviewsList reviewscounts any
reviews ReviewRowView[]
reviews:readany
POST /api/v1/store/reviews/bulkApprove, reject or delete several reviewsapplied integerreviews:writeadmin
GET /api/v1/store/reviews/exportExport reviews as CSVreviews:readadmin
POST /api/v1/store/reviews/importImport reviews from CSVcreated integer
errors any
products any
replaced any
skipped any
reviews:writeadmin
GET /api/v1/store/reviews/import/templateDownload the review import CSV templatereviews:readadmin
DELETE /api/v1/store/reviews/{id}Delete a reviewreviews:writeadmin
PUT /api/v1/store/reviews/{id}/featuredSet featuredsreview ReviewViewreviews:writeadmin
PUT /api/v1/store/reviews/{id}/replyReply to a reviewreview ReviewViewreviews:writeadmin
PUT /api/v1/store/reviews/{id}/statusSet statusreview ReviewViewreviews:writeadmin

Products

The catalogue: products, their variants, options and images.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/productsList productsproducts ProductListView[]products:readany
POST /api/v1/store/productsCreate a productproduct ProductViewproducts:writeadmin
POST /api/v1/store/products/bulk-axon-categorySet the Axon category on several productsids any
updated integer
products:writeadmin
POST /api/v1/store/products/bulk-deleteDelete several productsdeleted integer
ids any
products:writeadmin
GET /api/v1/store/products/exportExport products as Shopify-format CSVproducts:readadmin
GET /api/v1/store/products/handle-availableCheck whether a product handle is freeavailable booleanproducts:readany
POST /api/v1/store/products/importImport products from a Shopify-format CSVcleaned_cells any
created integer
errors any
renamed_skus any
skipped any
updated any
products:writeadmin
GET /api/v1/store/products/import/templateDownload the product import CSV templateproducts:readadmin
GET /api/v1/store/products/optionsList products as id and title, for pickersproducts CatalogProductOption[]products:readany
GET /api/v1/store/products/{id}Get a productproduct ProductViewproducts:readany
PUT /api/v1/store/products/{id}Update a productproduct ProductViewproducts:writeadmin
DELETE /api/v1/store/products/{id}Delete a productproducts:writeadmin

Shipping

Shipping zones and the rates inside them.

EndpointWhat it doesReturnsScopeRole
PUT /api/v1/store/shipping/rates/{id}Update a shipping raterate ShippingRateViewshipping:writeadmin
DELETE /api/v1/store/shipping/rates/{id}Delete a shipping rateshipping:writeadmin
GET /api/v1/store/shipping/zonesList shipping zoneszones ShippingZoneView[]shipping:readany
POST /api/v1/store/shipping/zonesCreate a shipping zonezone ShippingZoneViewshipping:writeadmin
PUT /api/v1/store/shipping/zones/{id}Update a shipping zonezone ShippingZoneViewshipping:writeadmin
DELETE /api/v1/store/shipping/zones/{id}Delete a shipping zoneshipping:writeadmin
POST /api/v1/store/shipping/zones/{id}/ratesAdd a rate to a shipping zonerate ShippingRateViewshipping:writeadmin

Shopify import

Importing a Shopify store's catalogue and content.

EndpointWhat it doesReturnsScopeRole
POST /api/v1/store/shopify-importStart a Shopify importimport_id integershopify-import:writeadmin
POST /api/v1/store/shopify-import/browserStart a browser-driven Shopify importimport_id integershopify-import:writeadmin
POST /api/v1/store/shopify-import/cancelCancel the running Shopify importcancelled booleanshopify-import:writeadmin
POST /api/v1/store/shopify-import/clearDelete everything a Shopify import createdshopify-import:writeadmin
GET /api/v1/store/shopify-import/latestGet the most recent Shopify importimport ShopifyimportStatusshopify-import:readany
POST /api/v1/store/shopify-import/probeProbe a Shopify store before importingprobe ShopifyimportProbeResultshopify-import:writeadmin
POST /api/v1/store/shopify-import/{id}/collectionsSubmit collections for a browser-driven Shopify importcounts ShopifyimportCounts
item_errors ShopifyimportItemError[]
shopify-import:writeadmin
POST /api/v1/store/shopify-import/{id}/finishFinish a browser-driven Shopify importdone boolean
failed any
tail any
shopify-import:writeadmin
POST /api/v1/store/shopify-import/{id}/productsSubmit products for a browser-driven Shopify importcounts ShopifyimportCounts
item_errors ShopifyimportItemError[]
shopify-import:writeadmin

Staff

Members of this store. Readable by an API key; not changeable by one.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/membersList staffmembers StoreMemberView[]staff:readany
POST /api/v1/store/members/inviteInvite a staff memberadded boolean
invited any
staff:writeadmin
PUT /api/v1/store/members/{userId}Set staffstaff:writeadmin
DELETE /api/v1/store/members/{userId}Remove a staff memberstaff:writeadmin

Store profile

The store itself: name, contact details, currency, units, and switching the storefront on or off.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/storeGet this storerole any
store any
store_id integer
store:readany
PUT /api/v1/storeUpdate a storestore StoreProfileViewstore:writeadmin
POST /api/v1/store/closeClose this storestore StoreProfileViewstore:writeany
PUT /api/v1/store/storefront-enabledSet storefront enabledsstore StoreProfileViewstore:writeadmin
GET /api/v1/store/storefront-funnelGet the storefront conversion funnelfunnel StoreeventsFunnelstore:readany

Store settings

The generic settings namespace.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/settingsList settingssettings StoreSettingView[]settings:readany
PUT /api/v1/store/settingsCreate or replace a settingsetting StoreSettingRefViewsettings:writeadmin

Tax

Tax rates by region.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/tax/ratesList shipping ratesrates TaxRateView[]tax:readany
POST /api/v1/store/tax/ratesCreate a shipping raterate TaxRateViewtax:writeadmin
PUT /api/v1/store/tax/rates/{id}Update a shipping raterate TaxRateViewtax:writeadmin
DELETE /api/v1/store/tax/rates/{id}Delete a shipping ratetax:writeadmin

Themes

Installed themes, their drafts, versions and the marketplace.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/themeGet a themetheme ThemeDraftViewthemes:readany
PUT /api/v1/store/themeUpdate a themeupdated_at string (date-time)themes:writeadmin
GET /api/v1/store/theme-marketList theme marketstemplates MarketTemplateListView[]themes:readany
POST /api/v1/store/theme-market/installInstall a theme from the marketplacetheme_id integerthemes:writeadmin
GET /api/v1/store/theme-market/{key}Get a theme markettemplate MarketTemplateViewthemes:readany
POST /api/v1/store/theme/publishPublish the active theme's draftpublication_id any
version integer
themes:writeadmin
POST /api/v1/store/theme/rollbackRoll the active theme back to an earlier versionversion integerthemes:writeadmin
GET /api/v1/store/theme/versionsList published versions of the active themeversions ThemeVersionView[]themes:readany
GET /api/v1/store/themesList themeslive_id integer
themes ThemeListView[]
themes:readany
POST /api/v1/store/themesCreate a themeid integerthemes:writeadmin
GET /api/v1/store/themes/{id}Get a themetheme ThemeDetailViewthemes:readany
PUT /api/v1/store/themes/{id}Update a themeupdated_at string (date-time)themes:writeadmin
PATCH /api/v1/store/themes/{id}Rename a themename stringthemes:writeadmin
DELETE /api/v1/store/themes/{id}Delete a themethemes:writeadmin
POST /api/v1/store/themes/{id}/duplicateDuplicate a themeid integerthemes:writeadmin
POST /api/v1/store/themes/{id}/preview-tokenMint a preview token for a themetoken stringthemes:writeadmin
POST /api/v1/store/themes/{id}/publishPublish a theme's draftpublication_id any
version integer
themes:writeadmin
POST /api/v1/store/themes/{id}/rollbackRoll a theme back to an earlier versionversion integerthemes:writeadmin
POST /api/v1/store/themes/{id}/update-from-templateUpdate an update from templatename any
theme_id integer
themes:writeadmin
GET /api/v1/store/themes/{id}/versionsList published versions of a themeversions ThemeVersionView[]themes:readany

Volume bundles

Buy-more-save-more offers and their tiers.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/bundlesList volume bundlesbundles BundleSummaryView[]bundles:readany
POST /api/v1/store/bundlesCreate a volume bundlebundle BundleOfferViewbundles:writeadmin
GET /api/v1/store/bundles/{id}Get a volume bundlebundle BundleOfferViewbundles:readany
PUT /api/v1/store/bundles/{id}Update a volume bundlebundle BundleOfferViewbundles:writeadmin
DELETE /api/v1/store/bundles/{id}Delete a volume bundlebundles:writeadmin

Webhooks

Outbound webhook subscriptions and their delivery history.

EndpointWhat it doesReturnsScopeRole
GET /api/v1/store/webhooksList webhook subscriptionswebhooks WebhookSubscriptionView[]webhooks:readany
POST /api/v1/store/webhooksCreate a webhook subscriptionwebhook WebhookSubscriptionViewwebhooks:writeadmin
PUT /api/v1/store/webhooks/{id}Update a webhook subscriptionwebhook WebhookSubscriptionViewwebhooks:writeadmin
DELETE /api/v1/store/webhooks/{id}Delete a webhook subscriptionwebhooks:writeadmin
GET /api/v1/store/webhooks/{id}/deliveriesList recent deliveries for a webhook subscriptiondeliveries WebhookDeliveryView[]webhooks:readany

Schemas

Reflected from the Go types the handlers return. A field marked required is always present.

APIKeyView

FieldTypeAlways present
created_atstring (date-time)yes
created_byintegeryes
expires_atstring (date-time)no
hintstringyes
idintegeryes
keystringno
last_used_atstring (date-time)no
namestringyes
revoked_atstring (date-time)no
rolestringyes
scopesstring[]yes
statusstringyes

AbandonedCartRowView

FieldTypeAlways present
abandoned_atstring (date-time)yes
currencystringyes
emailstringyes
item_countintegeryes
recoveredbooleanyes
recovered_atstring (date-time)no
recovery_emailsintegeryes
subtotal_centsintegeryes
tokenstringyes

AbandonedCheckoutRowView

FieldTypeAlways present
abandoned_atstring (date-time)no
attemptsintegeryes
created_atstring (date-time)yes
currencystringyes
emailstringyes
item_countintegeryes
payment_errorstringno
payment_statusstringno
recoveredbooleanyes
recovered_atstring (date-time)no
recovery_emailsintegeryes
statestringyes
tokenstringyes
total_centsintegeryes

AbandonedcartDetail

FieldTypeAlways present
abandoned_atstring (date-time)no
attemptsAbandonedcartPaymentAttempt[]yes
billing_addressanyno
created_atstring (date-time)yes
currencystringyes
discount_centsintegeryes
discount_codestringno
emailstringyes
expires_atstring (date-time)yes
linesAbandonedcartDetailLine[]yes
marketing_consentbooleanyes
phonestringyes
recovered_atstring (date-time)no
recovery_emailsintegeryes
shipping_addressanyno
shipping_centsintegeryes
shipping_lineanyno
statestringyes
subtotal_centsintegeryes
surcharge_centsintegeryes
tax_centsintegeryes
timelineAbandonedcartTimelineEvent[]yes
tip_centsintegeryes
tokenstringyes
total_centsintegeryes
updated_atstring (date-time)yes
utmobjectno

AbandonedcartDetailLine

FieldTypeAlways present
image_srcstringno
price_centsintegeryes
propertiesanyno
quantityintegeryes
skustringno
titlestringyes
variant_titlestringno

AbandonedcartPaymentAttempt

FieldTypeAlways present
amount_centsintegeryes
capture_modelstringno
created_atstring (date-time)yes
currencystringyes
errorstringno
payment_methodstringno
providerstringyes
statusstringyes
transaction_idintegeryes

AbandonedcartPolicy

FieldTypeAlways present
cartAbandonedcartSurfaceyes
checkoutAbandonedcartSurfaceyes

AbandonedcartSurface

FieldTypeAlways present
delays_minutesinteger[]yes
discount_enabledbooleanno
discount_from_stepintegerno
discount_ttl_hoursintegerno
discount_valueintegerno
discount_value_typestringno
idle_minutesintegeryes
modestringyes

AbandonedcartTimelineEvent

FieldTypeAlways present
amount_centsintegerno
currencystringno
detailobjectno
error_codestringno
error_messagestringno
namestringyes
occurred_atstring (date-time)yes
payment_methodstringno
providerstringno
sourcestringyes
transaction_idintegerno

AbandonmentStatsView

FieldTypeAlways present
recoveredintegeryes
recovered_centsintegeryes
recovery_ratenumberyes
totalintegeryes

AnalyticsCampaignStat

FieldTypeAlways present
campaignstringyes
gross_centsintegeryes
order_countintegeryes
sourcestringyes

AnalyticsCustomers

FieldTypeAlways present
newintegeryes
returningintegeryes
returning_ratenumberyes

AnalyticsDeltas

FieldTypeAlways present
aov_pctnumberno
gross_pctnumberno
orders_pctnumberno

AnalyticsDiscountStat

FieldTypeAlways present
codestringyes
discount_centsintegeryes
order_countintegeryes

AnalyticsFunnelStat

FieldTypeAlways present
acceptedintegeryes
accepts_per_entrynumberyes
enteredintegeryes
funnel_idintegeryes
namestringyes
revenue_centsintegeryes

AnalyticsMetrics

FieldTypeAlways present
aov_centsintegeryes
discount_centsintegeryes
gross_centsintegeryes
net_centsintegeryes
order_countintegeryes
refund_centsintegeryes
refunded_order_countintegeryes
shipping_centsintegeryes
tax_centsintegeryes
tip_centsintegeryes
unitsintegeryes

AnalyticsOverview

FieldTypeAlways present
by_campaignAnalyticsCampaignStat[]yes
by_sourceAnalyticsSourceStat[]yes
customersAnalyticsCustomersyes
deltasAnalyticsDeltasyes
fromstringyes
intervalstringyes
metricsAnalyticsMetricsyes
previousAnalyticsMetricsyes
seriesAnalyticsSeriesPoint[]yes
tostringyes
top_discountsAnalyticsDiscountStat[]yes
top_productsAnalyticsProductStat[]yes

AnalyticsProductStat

FieldTypeAlways present
product_idintegeryes
revenue_centsintegeryes
titlestringyes
unitsintegeryes

AnalyticsSeriesPoint

FieldTypeAlways present
bucketstringyes
gross_centsintegeryes
order_countintegeryes

AnalyticsSourceStat

FieldTypeAlways present
gross_centsintegeryes
order_countintegeryes
sourcestringyes

AnalyticsStepStat

FieldTypeAlways present
acceptedintegeryes
add_ratenumberyes
chargedintegeryes
declinedintegeryes
funnel_idintegeryes
funnel_namestringyes
positionintegeryes
product_idintegeryes
product_titlestringyes
sales_centsintegeryes
shownintegeryes
step_namestringyes
unavailableintegeryes
undecidedintegeryes
unitsintegeryes
variant_idintegeryes
zone_idintegeryes
zone_namestringyes

AnalyticsUTMStat

FieldTypeAlways present
campaignstringyes
contentstringyes
gross_centsintegeryes
mediumstringyes
order_countintegeryes
sourcestringyes
termstringyes

AnalyticsUpsellDeepReport

FieldTypeAlways present
by_stepAnalyticsStepStat[]yes
by_zone_funnelAnalyticsZoneFunnelStat[]yes
fromstringyes
intervalstringyes
kpisAnalyticsUpsellKPIsyes
seriesAnalyticsUpsellSeriesPoint[]yes
tostringyes
utmAnalyticsUTMStat[]yes
utm_total_gross_centsintegeryes
utm_total_ordersintegeryes

AnalyticsUpsellKPIs

FieldTypeAlways present
acceptedintegeryes
aov_centsintegeryes
cartsintegeryes
cohort_ordersintegeryes
cohort_revenue_centsintegeryes
completedintegeryes
declinedintegeryes
enteredintegeryes
offers_shownintegeryes
order_crnumberyes
ordersintegeryes
revenue_centsintegeryes
surcharge_centsintegeryes
unavailableintegeryes
undecidedintegeryes
upsell_crnumberyes
upsell_order_crnumberyes
upsell_ordersintegeryes
upsell_revenue_centsintegeryes

AnalyticsUpsellReport

FieldTypeAlways present
acceptedintegeryes
by_funnelAnalyticsFunnelStat[]yes
completedintegeryes
declinedintegeryes
enteredintegeryes
fromstringyes
offers_shownintegeryes
otherintegeryes
surcharge_centsintegeryes
take_ratenumberyes
tostringyes
upsell_linesintegeryes
upsell_ordersintegeryes
upsell_revenue_centsintegeryes

AnalyticsUpsellSeriesPoint

FieldTypeAlways present
acceptedintegeryes
bucketstringyes
cartsintegeryes
cohort_ordersintegeryes
enteredintegeryes
order_crnumberyes
ordersintegeryes
revenue_centsintegeryes
shownintegeryes
upsell_crnumberyes
upsell_ordersintegeryes
upsell_revenue_centsintegeryes

AnalyticsZoneFunnelStat

FieldTypeAlways present
aov_centsintegeryes
cartsintegeryes
funnel_idintegeryes
funnel_namestringyes
order_crnumberyes
ordersintegeryes
revenue_centsintegeryes
upsell_ordersintegeryes
upsell_revenue_centsintegeryes
zone_idintegeryes
zone_namestringyes

ArticleView

FieldTypeAlways present
authorstringyes
body_htmlstringyes
created_atstring (date-time)yes
excerptstringyes
handlestringyes
idintegeryes
image_srcstringyes
image_thumbhashstringyes
publishedbooleanyes
published_atstring (date-time)no
seoanyyes
tagsstring[]yes
titlestringyes
updated_atstring (date-time)yes

AuditLog

FieldTypeAlways present
actionstringyes
actor_idintegerno
actor_typestringyes
created_atstring (date-time)yes
idintegeryes
ipstringyes
metadataobjectyes
methodstringyes
pathstringyes
status_codeintegeryes
store_idintegerno
user_agentstringyes

AwaitingCaptureView

FieldTypeAlways present
amount_centsintegeryes
attemptsintegeryes
authorized_atstring (date-time)yes
capture_modelstringyes
currencystringyes
current_positionintegerno
draft_order_idintegeryes
emailstringyes
errorstringyes
expires_atstring (date-time)no
funnel_idintegerno
funnel_namestringno
has_funnelbooleanyes
needs_attentionbooleanyes
offer_countintegerno
providerstringyes
statestringyes
total_centsintegeryes
transaction_idintegeryes

BillingCardDTO

FieldTypeAlways present
brandstringyes
exp_monthintegeryes
exp_yearintegeryes
idintegeryes
is_defaultbooleanyes
last4stringyes

BillingInvoiceDTO

FieldTypeAlways present
amount_paid_centsintegeryes
attempt_countintegeryes
currencystringyes
due_atstringno
external_idstringyes
idintegeryes
issued_atstringyes
last_errorstringyes
notestringyes
numberstringyes
paid_atstringno
paid_viastringyes
period_endstringyes
period_startstringyes
statusstringyes
store_handlestringno
store_idintegeryes
store_namestringno
subtotal_centsintegeryes
total_centsintegeryes

BillingPlanDTO

FieldTypeAlways present
billing_intervalstringyes
currencystringyes
descriptionstringyes
featuresstring[]yes
idintegeryes
is_defaultbooleanyes
keystringyes
namestringyes
price_centsintegeryes
sortintegeryes
statusstringyes
transaction_fee_bpsintegeryes
transaction_fee_fixed_centsintegeryes
trial_daysintegeryes

BillingSubscriptionDTO

FieldTypeAlways present
billing_intervalstringyes
cancel_at_period_endbooleanyes
currencystringyes
current_period_endstringyes
current_period_startstringyes
idintegeryes
plan_idintegeryes
price_centsintegeryes
statusstringyes
store_idintegeryes
transaction_fee_bpsintegeryes
transaction_fee_fixed_centsintegeryes
trial_ends_atstringno

BundleOfferTierView

FieldTypeAlways present
benefit_labelstringyes
captionstringyes
discount_bpsintegeryes
discount_displaystringyes
free_shippingbooleanyes
idintegeryes
labelstringyes
preselectedbooleanyes
quantityintegeryes
titlestringyes

BundleOfferView

FieldTypeAlways present
applies_tostringyes
collection_idsinteger[]yes
enabledbooleanyes
idintegeryes
include_plain_itemsbooleanyes
product_idsinteger[]yes
tiersBundleOfferTierView[]yes
titlestringyes
variant_selectorsbooleanyes
variant_selectors_singlebooleanyes

BundleSummaryView

FieldTypeAlways present
applies_tostringyes
collection_countintegeryes
enabledbooleanyes
idintegeryes
include_plain_itemsbooleanyes
product_countintegeryes
tier_countintegeryes
titlestringyes

CardFieldsView

FieldTypeAlways present
eligiblebooleanyes
enabledbooleanyes
probedbooleanyes
probed_atstringyes
supportedbooleanyes

CatalogCollectionOption

FieldTypeAlways present
handlestringyes
idintegeryes
image_srcstringyes
publishedbooleanyes
titlestringyes

CatalogProductOption

FieldTypeAlways present
handlestringyes
idintegeryes
image_srcstringyes
statusstringyes
titlestringyes

CheckoutPageListView

FieldTypeAlways present
funnel_countintegeryes
idintegeryes
is_defaultbooleanyes
namestringyes
sectionsanyno
updated_atstring (date-time)yes

CheckoutPageRefView

FieldTypeAlways present
idintegeryes
is_defaultbooleanyes
namestringyes

CheckoutPageView

FieldTypeAlways present
idintegeryes
is_defaultbooleanyes
namestringyes
sectionsanyno
updated_atstring (date-time)yes

CheckoutZoneFunnelView

FieldTypeAlways present
enabledbooleanyes
funnel_idintegeryes
funnel_namestringyes
positionintegeryes
weightintegeryes

CheckoutZoneView

FieldTypeAlways present
catch_allbooleanyes
countriesstring[]yes
funnelsCheckoutZoneFunnelView[]yes
idintegeryes
namestringyes
positionintegeryes
region_warningstringno

CollectionListView

FieldTypeAlways present
collection_typestringyes
created_atstring (date-time)yes
descriptionstringyes
disjunctivebooleanyes
handlestringyes
idintegeryes
image_srcstringyes
products_countintegeryes
publishedbooleanyes
rulesanyyes
seoanyyes
sort_orderstringyes
titlestringyes
updated_atstring (date-time)yes

CollectionMemberView

FieldTypeAlways present
handlestringyes
idintegeryes
image_srcstringyes
positionintegeryes
price_centsintegeryes
statusstringyes
titlestringyes

CollectionView

FieldTypeAlways present
collection_typestringyes
created_atstring (date-time)yes
descriptionstringyes
disjunctivebooleanyes
handlestringyes
idintegeryes
image_srcstringyes
publishedbooleanyes
rulesanyyes
seoanyyes
sort_orderstringyes
titlestringyes
updated_atstring (date-time)yes

CustomizerCondition

FieldTypeAlways present
opstringyes
option_idintegeryes
valuestringno
valuesstring[]no

CustomizerFunction

FieldTypeAlways present
element_keystringno
group_keystringno
propertystringyes
valuestringyes

CzDesignView

FieldTypeAlways present
height_pxintegeryes
idintegeryes
namestringyes
width_pxintegeryes

CzElementView

FieldTypeAlways present
design_idintegeryes
element_keystringyes
group_keystringyes
hnumberyes
idintegeryes
rotation_degnumberyes
settingsanyyes
typestringyes
wnumberyes
xnumberyes
ynumberyes
z_indexintegeryes

CzLibraryCatalogueView

FieldTypeAlways present
finishesintegeryes
group_keystringyes
holesintegeryes
itemsintegeryes

CzLibraryItemView

FieldTypeAlways present
idintegeryes
library_idintegeryes
positionintegeryes
valueanyyes

CzLibraryView

FieldTypeAlways present
group_keystringyes
idintegeryes
kindstringyes
namestringyes
scope_valuestringyes

CzMockupView

FieldTypeAlways present
idintegeryes
image_heightintegeryes
image_srcstringyes
image_widthintegeryes
namestringyes
positionintegeryes
product_base_idintegeryes

CzOptionSetView

FieldTypeAlways present
idintegeryes
namestringyes

CzOptionValueView

FieldTypeAlways present
functionsCustomizerFunction[]yes
idintegeryes
labelstringyes
option_idintegeryes
positionintegeryes
price_delta_centsintegeryes
thumbnail_urlstringyes
valuestringyes

CzOptionView

FieldTypeAlways present
conditionsCustomizerCondition[]yes
help_textstringyes
idintegeryes
labelstringyes
option_set_idintegeryes
positionintegeryes
price_per_char_centsintegeryes
requiredbooleanyes
sectionstringyes
settingsanyyes
typestringyes
validationCzTextValidationViewyes

CzPreviewBindingView

FieldTypeAlways present
default_selectionsobjectyes
idintegeryes
library_scopestringyes
option_namestringyes
option_set_idintegeryes
option_set_namestringyes
option_valuestringyes
product_handlestringyes
product_idintegeryes
product_titlestringyes
template_idintegeryes

CzPreviewOptionSetView

FieldTypeAlways present
idintegeryes
namestringyes
optionsCzPreviewOptionView[]yes

CzPreviewOptionView

FieldTypeAlways present
conditionsCustomizerCondition[]yes
help_textstringyes
idintegeryes
labelstringyes
option_set_idintegeryes
positionintegeryes
price_per_char_centsintegeryes
requiredbooleanyes
sectionstringyes
settingsanyyes
typestringyes
validationCzTextValidationViewyes
valuesCzOptionValueView[]yes

CzPrintAreaView

FieldTypeAlways present
hnumberyes
idintegeryes
mockup_idintegeryes
namestringyes
positionintegeryes
rotation_degnumberyes
wnumberyes
xnumberyes
ynumberyes

CzProductBaseView

FieldTypeAlways present
idintegeryes
namestringyes

CzProductBindingView

FieldTypeAlways present
default_selectionsobjectyes
idintegeryes
library_scopestringyes
option_namestringyes
option_set_idintegeryes
option_valuestringyes
product_idintegeryes
template_idintegeryes

CzQuantityTierView

FieldTypeAlways present
idintegeryes
min_qtyintegeryes
positionintegeryes
price_centsintegeryes
template_idintegeryes

CzReplaceOptionValuesView

FieldTypeAlways present
createdintegeryes
deletedintegeryes
updatedintegeryes
valuesCzOptionValueView[]yes

CzSelectionView

FieldTypeAlways present
pickedbooleanyes
rawstringyes
value_idintegeryes

CzStudioElementView

FieldTypeAlways present
design_idintegeryes
element_keystringyes
group_keystringyes
hnumberyes
idintegeryes
referenced_byintegeryes
rotation_degnumberyes
settingsanyyes
typestringyes
wnumberyes
xnumberyes
ynumberyes
z_indexintegeryes

CzStudioMockupView

FieldTypeAlways present
idintegeryes
image_heightintegeryes
image_srcstringyes
image_widthintegeryes
namestringyes
positionintegeryes
print_areasCzPrintAreaView[]yes
product_base_idintegeryes

CzStudioPlacementView

FieldTypeAlways present
baseCzProductBaseViewyes
mockupsCzStudioMockupView[]yes
templateCzTemplateViewyes

CzStudioView

FieldTypeAlways present
designCzDesignViewyes
elementsCzStudioElementView[]yes
placementsCzStudioPlacementView[]yes

CzTemplatePreviewView

FieldTypeAlways present
baseCzProductBaseViewyes
bindingCzPreviewBindingViewno
bindingsCzPreviewBindingView[]yes
designCzDesignViewyes
elementsCzElementView[]yes
mockupsCzStudioMockupView[]yes
option_setCzPreviewOptionSetViewno
quantity_tiersCzQuantityTierView[]yes
templateCzTemplateViewyes

CzTemplateView

FieldTypeAlways present
design_idintegeryes
export_formatstringyes
idintegeryes
included_colorsintegeryes
included_elementsintegeryes
namestringyes
ppiintegeryes
price_per_extra_color_centsintegeryes
price_per_extra_element_centsintegeryes
product_base_idintegeryes

CzTextValidationView

FieldTypeAlways present
chars_per_lineintegeryes
max_lengthintegeryes
max_linesintegeryes
modestringyes
patternstringyes

DiscountDetailView

FieldTypeAlways present
applies_tostringyes
buy_collection_idsinteger[]yes
buy_product_idsinteger[]yes
buy_quantityintegeryes
classstringyes
codestringyes
collection_idsinteger[]yes
enabledbooleanyes
ends_atstring (date-time)no
get_collection_idsinteger[]yes
get_product_idsinteger[]yes
get_quantityintegeryes
get_valueintegeryes
get_value_typestringyes
idintegeryes
minimum_subtotal_centsintegeryes
once_per_customerbooleanyes
per_customer_limitintegerno
product_idsinteger[]yes
starts_atstring (date-time)no
typestringyes
usage_limitintegerno
used_countintegeryes
valueintegeryes
value_typestringyes

DiscountView

FieldTypeAlways present
applies_tostringyes
buy_quantityintegeryes
classstringyes
codestringyes
enabledbooleanyes
ends_atstring (date-time)no
get_quantityintegeryes
get_valueintegeryes
get_value_typestringyes
idintegeryes
minimum_subtotal_centsintegeryes
once_per_customerbooleanyes
per_customer_limitintegerno
starts_atstring (date-time)no
typestringyes
usage_limitintegerno
used_countintegeryes
valueintegeryes
value_typestringyes

DomainView

FieldTypeAlways present
dns_recordsDomainmgrDNSRecord[]yes
hostnamestringyes
idintegeryes
is_primarybooleanyes
last_errorstringyes
ssl_statusstringyes
statusstringyes
verification_recordsanyyes

DomainmgrDNSRecord

FieldTypeAlways present
namestringyes
notestringno
purposestringyes
typestringyes
valuestringyes

DraftOrderLineView

FieldTypeAlways present
custombooleanyes
idintegeryes
line_total_centsintegeryes
price_centsintegeryes
quantityintegeryes
skustringyes
titlestringyes
variant_idintegerno
variant_titlestringyes

DraftOrderView

FieldTypeAlways present
currencystringyes
emailstringyes
idintegeryes
invoice_sent_atstring (date-time)no
linesDraftOrderLineView[]yes
namestringyes
notestringyes
order_idintegerno
statusstringyes
subtotal_centsintegeryes
tagsstring[]yes
tokenstringyes
total_centsintegeryes

Error

FieldTypeAlways present
messagestringyes
statusbooleanyes

FeatureflagsPP15Config

FieldTypeAlways present
activebooleanyes
cap_centsintegeryes
value_bpsintegeryes

FormSubmissionView

FieldTypeAlways present
created_atstring (date-time)yes
emailstringyes
idstringyes
messagestringyes
namestringyes
readbooleanyes
read_atstring (date-time)no
source_urlstringyes
typestringyes

FulfilledQuantityView

FieldTypeAlways present
line_item_idintegeryes
quantityintegeryes

FulfillmentView

FieldTypeAlways present
carrierstringyes
created_atstring (date-time)yes
idintegeryes
notestringyes
order_idintegeryes
statusstringyes
tracking_numberstringyes
tracking_urlstringyes

FunnelStepView

FieldTypeAlways present
accept_next_positionintegerno
configanyyes
decline_next_positionintegerno
idintegeryes
namestringyes
positionintegeryes
typestringyes
upsell_pageanyyes

FunnelSummaryView

FieldTypeAlways present
checkout_page_idintegerno
enabledbooleanyes
idintegeryes
namestringyes
timeout_secondsintegeryes

FunnelView

FieldTypeAlways present
checkout_page_idintegerno
enabledbooleanyes
idintegeryes
namestringyes
offersFunnelStepView[]yes
pp15FeatureflagsPP15Configno
timeout_secondsintegeryes
tippingTippingConfigno
upsell_pageanyyes

KlaviyoAccountView

FieldTypeAlways present
idstringyes
namestringyes
test_accountbooleanyes

KlaviyoCredentialsView

FieldTypeAlways present
account_idstringyes
account_namestringyes
auth_methodstringyes
backfill_doneintegeryes
backfill_statusstringyes
backfill_totalintegeryes
enabledbooleanyes
has_keybooleanyes
key_hintstringyes
list_idstringyes
list_namestringyes
metric_variantstringyes
test_accountbooleanyes

KlaviyoListDTO

FieldTypeAlways present
idstringyes
namestringyes
opt_in_processstringyes

KlaviyoPublicConfig

FieldTypeAlways present
added_to_cartbooleanyes
onsite_enabledbooleanyes
site_idstringyes
viewed_productbooleanyes

KlaviyoView

FieldTypeAlways present
credentialsKlaviyoCredentialsViewyes
publicKlaviyoPublicConfigyes

MarketTemplateListView

FieldTypeAlways present
authorstringyes
categorystringyes
currencystringyes
descriptionstringyes
familystringyes
keystringyes
latest_versionintegeryes
namestringyes
ownedbooleanyes
preview_imagesanyyes
price_centsintegeryes
taglinestringyes
theme_versionstringyes
thumbnail_urlstringyes

MarketTemplateView

FieldTypeAlways present
authorstringyes
categorystringyes
currencystringyes
descriptionstringyes
familystringyes
keystringyes
latest_versionintegeryes
namestringyes
preview_imagesanyyes
price_centsintegeryes
taglinestringyes
theme_versionstringyes
thumbnail_urlstringyes

MenuRefView

FieldTypeAlways present
handlestringyes
titlestringyes

MenuView

FieldTypeAlways present
handlestringyes
itemsanyyes
titlestringyes

OrderAttributionView

FieldTypeAlways present
utm_campaignstringyes
utm_contentstringyes
utm_mediumstringyes
utm_sourcestringyes
utm_termstringyes

OrderCustomerView

FieldTypeAlways present
accepts_marketingbooleanyes
created_atstring (date-time)yes
emailstringyes
first_namestringyes
idintegeryes
last_namestringyes
orders_countintegeryes
phonestringyes

OrderDetailView

FieldTypeAlways present
attributionOrderAttributionViewno
billing_addressanyyes
cancel_reasonstringyes
cancelled_atstring (date-time)no
checkout_started_atstring (date-time)no
created_atstring (date-time)yes
currencystringyes
customerOrderCustomerViewno
discount_centsintegeryes
discount_codestringyes
emailstringyes
financial_statusstringyes
fulfillment_statusstringyes
idintegeryes
line_itemsOrderLineItemView[]yes
notestringyes
order_numberintegeryes
order_number_displaystringyes
paid_atstring (date-time)no
shipping_addressanyyes
shipping_centsintegeryes
shipping_lineanyyes
statusstringyes
subtotal_centsintegeryes
system_tagsstring[]yes
tagsstring[]yes
tax_centsintegeryes
tip_centsintegeryes
tokenstringyes
total_centsintegeryes
transactionsOrderTransactionView[]yes
upsellOrderUpsellViewno

OrderLineItemView

FieldTypeAlways present
bundle_groupstringno
bundle_titlestringno
idintegeryes
image_srcstringyes
image_thumbhashstringyes
original_price_centsintegerno
price_centsintegeryes
propertiesobjectno
quantityintegeryes
requires_shippingbooleanyes
skustringyes
sourcestringyes
titlestringyes
variant_titlestringyes

OrderSummaryView

FieldTypeAlways present
created_atstring (date-time)yes
currencystringyes
emailstringyes
financial_statusstringyes
fulfillment_statusstringyes
idintegeryes
order_numberintegeryes
order_number_displaystringyes
statusstringyes
system_tagsstring[]yes
tagsstring[]yes
total_centsintegeryes

OrderTransactionView

FieldTypeAlways present
amount_centsintegeryes
created_atstring (date-time)yes
currencystringyes
errorstringno
external_idstringyes
idintegeryes
kindstringyes
payment_methodstringno
providerstringyes
statusstringyes

OrderUpsellView

FieldTypeAlways present
entered_atstring (date-time)yes
funnel_namestringyes
statusstringyes

PP15PlatformView

FieldTypeAlways present
post_upsell_enabledbooleanyes
pp15_enabledbooleanyes

PageView

FieldTypeAlways present
body_htmlstringyes
created_atstring (date-time)yes
handlestringyes
idintegeryes
publishedbooleanyes
published_atstring (date-time)no
seoanyyes
titlestringyes
updated_atstring (date-time)yes

PaymentFeaturesView

FieldTypeAlways present
holds_funds_at_checkoutbooleanyes
manual_capturebooleanyes
refundsbooleanyes
settle_retryablebooleanyes
upsellbooleanyes
walletsstring[]yes
webhook_autoregbooleanyes

PaymentProviderView

FieldTypeAlways present
capabilitiesanyyes
card_fieldsCardFieldsViewyes
display_namestringyes
enabledbooleanyes
featuresPaymentFeaturesViewyes
has_credentialsbooleanyes
has_webhook_secretbooleanyes
idintegeryes
modestringyes
providerstringyes
public_configanyyes
public_idstringyes
wallet_domainsWalletDomainView[]yes
webhook_pathstringyes
webhook_registeredbooleanyes
webhook_urlstringyes

ProductImageView

FieldTypeAlways present
altstringyes
heightintegeryes
idintegeryes
positionintegeryes
srcstringyes
thumbhashstringyes
widthintegeryes

ProductListView

FieldTypeAlways present
handlestringyes
idintegeryes
image_srcstringno
price_centsintegerno
product_typestringyes
rating_avgintegeryes
rating_countintegeryes
statusstringyes
tagsstring[]yes
titlestringyes
updated_atstring (date-time)yes
vendorstringyes

ProductOptionView

FieldTypeAlways present
namestringyes
positionintegeryes
valuesstring[]yes

ProductVariantView

FieldTypeAlways present
barcodestringyes
compare_at_price_centsintegerno
cost_centsintegerno
idintegeryes
image_idintegerno
inventory_policystringyes
inventory_quantityintegeryes
option1stringyes
option2stringyes
option3stringyes
positionintegeryes
price_centsintegeryes
requires_shippingbooleanyes
skustringyes
taxablebooleanyes
titlestringyes
track_inventorybooleanyes
weight_gramsintegeryes

ProductView

FieldTypeAlways present
axon_category_idintegeryes
body_htmlstringyes
collection_idsinteger[]yes
handlestringyes
idintegeryes
imagesProductImageView[]yes
optionsProductOptionView[]yes
product_typestringyes
rating_avgintegeryes
rating_countintegeryes
seoanyyes
statusstringyes
tagsstring[]yes
titlestringyes
updated_atstring (date-time)yes
variantsProductVariantView[]yes
vendorstringyes

RefundView

FieldTypeAlways present
amount_centsintegeryes
currencystringyes
idintegeryes
order_financial_statusstringyes
statusstringyes

RenderView

FieldTypeAlways present
height_pxintegerno
idintegerno
line_item_idintegeryes
notestringno
statusstringyes
titlestringyes
variant_titlestringyes
width_pxintegerno

ReviewPhoto

FieldTypeAlways present
heightintegeryes
srcstringyes
thumbhashstringno
widthintegeryes

ReviewRowView

FieldTypeAlways present
authorstringyes
bodystringyes
created_atstring (date-time)yes
emailstringyes
featuredbooleanyes
idstringyes
order_idstringno
photosReviewPhoto[]yes
product_handlestringyes
product_idstringyes
product_titlestringyes
ratingintegeryes
replied_atstring (date-time)no
replystringyes
sourcestringyes
statusstringyes
titlestringyes
verifiedbooleanyes

ReviewView

FieldTypeAlways present
authorstringyes
bodystringyes
created_atstring (date-time)yes
emailstringyes
featuredbooleanyes
idstringyes
order_idstringno
photosReviewPhoto[]yes
product_idstringyes
ratingintegeryes
replied_atstring (date-time)no
replystringyes
sourcestringyes
statusstringyes
titlestringyes
verifiedbooleanyes

ScopeResourceView

FieldTypeAlways present
labelstringyes
resourcestringyes

ShippingRateView

FieldTypeAlways present
idintegeryes
max_subtotal_centsintegerno
max_weight_gramsintegerno
min_subtotal_centsintegerno
min_weight_gramsintegerno
namestringyes
positionintegeryes
price_centsintegeryes
zone_idintegeryes

ShippingZoneView

FieldTypeAlways present
countriesstring[]yes
default_rate_idintegerno
idintegeryes
namestringyes
positionintegeryes
ratesShippingRateView[]yes
region_warningstringno

ShopifyimportCounts

FieldTypeAlways present
articlesintegeryes
collectionsintegeryes
imagesintegeryes
pagesintegeryes
productsintegeryes

ShopifyimportItemError

FieldTypeAlways present
msgstringyes
phasestringyes

ShopifyimportProbeResult

FieldTypeAlways present
articlesintegeryes
collectionsintegeryes
collections_at_leastbooleanyes
domainstringyes
has_blogbooleanyes
import_limitintegeryes
is_shopifybooleanyes
pagesintegeryes
productsintegeryes
store_namestringyes

ShopifyimportStatus

FieldTypeAlways present
countsShopifyimportCountsyes
error_messagestringyes
errorsShopifyimportItemError[]yes
finished_atstringyes
idintegeryes
modestringyes
phasestringyes
sourcestringyes
started_atstringyes
statusstringyes

StoreMemberView

FieldTypeAlways present
emailstringyes
namestringyes
rolestringyes
statusstringyes
user_idintegeryes

StoreProfileView

FieldTypeAlways present
addressanyyes
contact_emailstringyes
contact_phonestringyes
currencystringyes
handlestringyes
idintegeryes
localestringyes
namestringyes
order_number_prefixstringyes
order_number_suffixstringyes
statusstringyes
timezonestringyes
weight_unitstringyes

StoreSettingRefView

FieldTypeAlways present
keystringyes
namespacestringyes

StoreSettingView

FieldTypeAlways present
keystringyes
namespacestringyes
valueanyyes

StoreeventsFunnel

FieldTypeAlways present
added_to_cartintegeryes
purchasedintegeryes
reached_checkoutintegeryes
sessionsintegeryes
viewed_productintegeryes

StoremailConfig

FieldTypeAlways present
enabledbooleanyes
encryptionstringyes
from_emailstringyes
from_namestringyes
has_passwordbooleanyes
hoststringyes
portintegeryes
reply_tostringyes
usernamestringyes

TaxRateView

FieldTypeAlways present
countrystringyes
idintegeryes
namestringyes
positionintegeryes
provincestringyes
rate_bpsintegeryes
region_warningstringno

ThemeDetailView

FieldTypeAlways present
base_keystringyes
draft_settingsanyyes
idintegeryes
namestringyes
source_template_keystringno
source_theme_versionstringno
thumbnail_urlstringno

ThemeDraftView

FieldTypeAlways present
base_keystringyes
draft_settingsanyyes
idintegeryes
namestringyes

ThemeListView

FieldTypeAlways present
idintegeryes
latest_theme_versionstringno
livebooleanyes
namestringyes
source_template_keystringno
source_theme_versionstringno
thumbnail_urlstringno
update_availablebooleanno
updated_atstring (date-time)yes

ThemeVersionView

FieldTypeAlways present
publication_idintegeryes
published_atstring (date-time)yes
versionintegeryes

TippingConfig

FieldTypeAlways present
allow_custombooleanyes
default_presetintegerno
descriptionstringno
enabledbooleanyes
labelstringno
max_percentintegerno
modestringno
presetsinteger[]yes

TrackingAxonCAPIView

FieldTypeAlways present
enabledbooleanyes
has_tokenbooleanyes
pixel_idstringyes

TrackingAxonConfig

FieldTypeAlways present
category_idintegerno
event_keysstring[]yes

TrackingCAPIView

FieldTypeAlways present
enabledbooleanyes
has_tokenbooleanyes
pixel_idstringyes
test_event_codestringyes

TrackingConfig

FieldTypeAlways present
axonTrackingAxonConfigyes
googleTrackingGoogleConfigyes
metaTrackingMetaConfigyes
optionsTrackingOptionsyes
pinterestTrackingPinterestConfigyes
tiktokTrackingTikTokConfigyes

TrackingGoogleConfig

FieldTypeAlways present
ads_labelsobjectyes
tag_idsstring[]yes

TrackingMetaConfig

FieldTypeAlways present
pixel_idsstring[]yes
test_event_codestringyes

TrackingOptions

FieldTypeAlways present
content_idstringyes
debugbooleanyes

TrackingPinterestConfig

FieldTypeAlways present
tag_idsstring[]yes

TrackingTikTokConfig

FieldTypeAlways present
pixel_idsstring[]yes

WalletDomainView

FieldTypeAlways present
hoststringyes
registeredbooleanyes
registered_atstringyes

WalletRegistrationView

FieldTypeAlways present
errorstringno
hoststringyes
registeredbooleanyes

WebhookDeliveryView

FieldTypeAlways present
attemptsintegeryes
idintegeryes
last_errorstringyes
last_status_codeintegeryes
statusstringyes
topicstringyes

WebhookSubscriptionView

FieldTypeAlways present
activebooleanyes
idintegeryes
secretstringno
topicsstring[]yes
urlstringyes