blog_posts
ChatGPTBlog posts. Read-only; changes nothing. Money is integer minor units (cents).
blog_posts_create
ChatGPTWrite a blog post. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
blog_posts_delete
ChatGPTDelete a blog post. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
blog_posts_edit
ChatGPTChange a blog post. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
blog_posts_set_status
ChatGPTPublish, schedule or unpublish a blog post. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
branding_set
ChatGPTSet the shop's logo and the one its emails carry. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
changes_status
ChatGPTWhat became of a change proposed here: pending, confirmed, rejected or expired, by the change_id a capability tool or propose_plan returned. Read-only.
check_own_theme
ChatGPTCheck that an own theme installs, and list anything the installer would drop. Changes nothing.
collections_add_products
ChatGPTPut products in a category. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
collections_create
ChatGPTAdd a category. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
collections_delete
ChatGPTDelete a category. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
collections_edit
ChatGPTChange a category. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
collections_remove_products
ChatGPTTake products out of a category. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
collections_set_rules
ChatGPTMake a category fill itself, or arrange it by hand. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
create_own_theme
ChatGPTStart a theme of the merchant's own, from the starter theme (complete, installs as is) unless asked for a blank one. Use when the merchant wants a design from scratch rather than changes to the theme they wear. Call get_design_guide first: it has the file format and the layout language.
customers_change_email
ChatGPTMove a customer to another email. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
customers_create
ChatGPTAdd a customer. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
customers_delete
ChatGPTDelete a customer. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
customers_lookup
ChatGPTLook a customer up. Read-only; changes nothing. Money is integer minor units (cents).
customers_message
ChatGPTEmail a customer. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
customers_note
ChatGPTNote something on a customer. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
customers_send_signin_link
ChatGPTSend a customer a sign-in link. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
define_section
ChatGPTAuthor a new kind of section for this shop, as a layout tree. Use this when the shop has nothing that does what the merchant asked for. The type is forced into the custom. namespace and cannot shadow a built-in or the theme's. If it is refused you get the exact reasons back; fix them and try again. Call get_design_guide first if you have not: it has the layout language and the rules.
discounts_catalog_sale
ChatGPTRun a sale. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
discounts_coupon
ChatGPTCreate a coupon code. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
get_design_guide
ChatGPTThe design guide: how pages, the header and footer, sections and themes work here, and the complete layout language (node types, expressions, components, CSS rules) that define_section and theme files are written in. Call it once before designing anything. With section, returns that theme or custom section's full definition (fields, render tree, CSS) as a worked example. With reference, the full reference the developer docs publish: "components" (every component's props and slots), "scopes" (every field in scope: product, cart, collection, search, account, order, blog), "data" (data sources), or one component's name. Read it before deciding something cannot be done: most of what a theme needs already exists there.
get_page
ChatGPTRead one page's current layout as a list of sections. Returns the draft if there is one, otherwise what is live. Call this before changing a page so you are editing what is actually there.
get_theme_settings
ChatGPTThe installed theme's own settings and their current values.
get_theme_tokens
ChatGPTThe shop's colours, fonts and shape, with their current values.
gift_cards_create
ChatGPTIssue a gift card. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
gift_cards_set_status
ChatGPTWithdraw a gift card, or put it back. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
imports_create
ChatGPTSet up a product import. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
imports_delete
ChatGPTRemove a product import. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
imports_inspect
ChatGPTRead a product file before importing it. Read-only; changes nothing. Money is integer minor units (cents).
imports_list
ChatGPTThe shop's product imports. Read-only; changes nothing. Money is integer minor units (cents).
imports_run
ChatGPTRun a product import now. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
imports_update
ChatGPTChange a product import. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
instagram_accounts
ChatGPTInstagram accounts. Read-only; changes nothing. Money is integer minor units (cents).
inventory_adjust
ChatGPTSet stock levels. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
inventory_low
ChatGPTStock running out. Read-only; changes nothing. Money is integer minor units (cents).
list_collections
ChatGPTThe shop's categories, to point a product grid at one.
list_content_types
ChatGPTCustom content types this shop has, and how many entries each holds.
list_own_themes
ChatGPTThe merchant's own themes: built for themselves, kept on their account, seen by nobody else. Not the catalogue.
list_pages
ChatGPTList this shop's pages and templates: handle, title, whether it is a template, and whether it has unpublished changes. Start here to find out what exists.
list_products
ChatGPTThe shop's products: id, handle, title, status, lowest price, and every variant with its id, title, SKU, price and stock. Use the id or handle with the tools that change products or prices. Prices are integer minor units (cents).
list_section_types
ChatGPTEvery kind of section this shop can use, with the settings each one takes. Includes the built-ins, the installed theme's, and any authored for this shop. Call this before writing sections so you use real types and real setting names.
orders_cancel
ChatGPTCancel an order. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
orders_create
ChatGPTCreate an order. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
orders_fulfil
ChatGPTMark an order as sent. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
orders_lookup
ChatGPTLook an order up. Read-only; changes nothing. Money is integer minor units (cents).
orders_mark_delivered
ChatGPTMark a parcel as delivered. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
orders_mark_paid
ChatGPTMark an order as paid. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
orders_note
ChatGPTNote something on an order. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
orders_refund
ChatGPTRefund an order. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
orders_remove_shipment
ChatGPTTake a parcel off an order. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
orders_send_payment_link
ChatGPTEmail a payment link. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
orders_ship_label
ChatGPTBook an order's parcel with the shop's carrier. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
orders_update_shipment
ChatGPTCorrect a parcel's carrier or tracking number. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
pickup_remove_location
ChatGPTRemove a collection point. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
pickup_set_location
ChatGPTAdd or change a collection point. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
plugins_available
ChatGPTPlugins the shop can add. Read-only; changes nothing. Money is integer minor units (cents).
plugins_install
ChatGPTInstall or update a free plugin. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
plugins_list
ChatGPTThe shop's plugins and their settings. Read-only; changes nothing. Money is integer minor units (cents).
plugins_set_enabled
ChatGPTSwitch a plugin off or on. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
plugins_settings
ChatGPTChange a plugin's settings. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
policies_write
ChatGPTWrite or update a policy page. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
products_add_image
ChatGPTAdd a picture to a product. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
products_bulk_price_edit
ChatGPTChange prices in bulk. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
products_create
ChatGPTAdd a product. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
products_delete
ChatGPTDelete a product. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
products_edit
ChatGPTChange a product. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
products_set_status
ChatGPTPublish or unpublish products. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
promotions_delete
ChatGPTRemove a promotion. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
promotions_edit
ChatGPTChange a promotion's terms. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
promotions_set_active
ChatGPTPause or resume a promotion. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
promotions_state
ChatGPTSales and discounts running. Read-only; changes nothing. Money is integer minor units (cents).
propose_plan
ChatGPTSeveral capability steps as ONE proposal: previewed together, confirmed once by the merchant, applied all-or-nothing. Use when the merchant asks for one thing that takes several steps (a sale plus its coupon). Each step names one of this connector's capability tools and gives that tool's input. Changes nothing by itself.
read_own_theme_file
ChatGPTRead one file of an own theme with its current revision. Path "" lists every file with its size. Paths: theme.json, theme.css, README.md, AGENTS.md, sections/<name>.json, templates/<handle>.json, styles/<key>.json.
redirects_list
ChatGPTThe shop's redirects. Read-only; changes nothing. Money is integer minor units (cents).
redirects_set
ChatGPTAdd or remove redirects. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
reviews_list
ChatGPTThe shop's reviews. Read-only; changes nothing. Money is integer minor units (cents).
reviews_set_status
ChatGPTHide or show reviews. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
reviews_settings
ChatGPTSet how the shop asks for reviews. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
routines_create
ChatGPTSet up a routine. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
routines_delete
ChatGPTStop a routine for good. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
routines_list
ChatGPTThe routines this shop runs. Read-only; changes nothing. Money is integer minor units (cents).
routines_update
ChatGPTChange a routine. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
sales_report
ChatGPTSales report. Read-only; changes nothing. Money is integer minor units (cents).
screenshot_own_theme
ChatGPTStage an own theme as this shop's draft and return a screenshot of one page, so you can see what you built.
seo_set
ChatGPTSet how the shop describes itself to search engines. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
set_page_sections
ChatGPTReplace a page's layout. Writes to the DRAFT only: nothing a shopper sees changes until the merchant presses Publish. Unknown section types and unknown setting keys are dropped, so read list_section_types first. Set enabled:false on a section to hide it while keeping its settings. Call get_design_guide first if you have not: it has the layout language and the rules.
set_theme_settings
ChatGPTChange the theme's own settings. These apply to every page at once. Values are held to the theme's declared fields; unknown keys are dropped.
set_theme_tokens
ChatGPTChange the shop's colours, fonts or shape. Keys come from get_theme_tokens, call it first. Colours are hex or rgb(); lengths carry a unit; picture shapes (imageRatioCard, imageRatioProduct) are width / height, like 2 / 3, or auto for pictures as uploaded. Anything that is not a valid value for that token is refused, and you will be told which.
settings_checkout
ChatGPTChoose which checkout shoppers pay on. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
settings_currencies
ChatGPTSet which currencies shoppers can read prices in. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
settings_customer_accounts
ChatGPTChoose whether shoppers can sign in. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
settings_details
ChatGPTSet the shop's name, tagline and contact email. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
settings_identity
ChatGPTSet who the seller legally is. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
settings_inventory
ChatGPTSet how the shop counts stock. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
settings_language
ChatGPTChange the shop's languages. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
settings_notifications
ChatGPTWrite the shop's own words on its order emails. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
settings_privacy
ChatGPTSet what the shop asks its shoppers. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
settings_store_defaults
ChatGPTSet the shop's clock, order names and units. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
settings_tax
ChatGPTSet the shop's tax line. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
settings_tax_rates
ChatGPTSet or remove the tax rate for a place. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
shipping_remove_method
ChatGPTRemove a delivery method. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
shipping_set_countries
ChatGPTSet where the shop ships to. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
shipping_set_defaults
ChatGPTSet the fallback delivery price. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
shipping_set_method
ChatGPTAdd or change a delivery method. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
shipping_set_zones
ChatGPTSet delivery areas. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
shop_state
ChatGPTHow the shop stands. Read-only; changes nothing. Money is integer minor units (cents).
shopping_feeds_list
ChatGPTThe shop's shopping feeds. Read-only; changes nothing. Money is integer minor units (cents).
shopping_feeds_set
ChatGPTSet the shop's shopping feeds. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
stage_own_theme
ChatGPTPut an own theme on this shop as its draft and return a link to walk the draft. The live shop does not change; the merchant publishes the draft from Design, Themes. Replaces whatever draft theme the shop had.
store_locator_remove
ChatGPTTake a store off the map. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
store_locator_set
ChatGPTPut a store on the map or change it. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
store_locator_stores
ChatGPTThe shop's stores. Read-only; changes nothing. Money is integer minor units (cents).
storefront_publish
ChatGPTOpen the shop to visitors, or take it offline. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
storefront_set_password
ChatGPTPut a password on the shop's front door, change it, or take it off. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
translations_missing
ChatGPTWhat still needs translating. Read-only; changes nothing. Money is integer minor units (cents).
translations_set
ChatGPTStore translations. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
upsert_content
ChatGPTCreate or update one entry of a custom content type, for example a banner. Fields are held to the type's declared shape.
write_own_theme_files
ChatGPTWrite several files of an own theme at once: changes maps a path to its whole new content, or null to delete it. Pass the revision you last read as baseRevision; if the theme changed since, nothing is written. The theme is checked first: a write that would leave it not installing saves nothing and says why. Changes the theme's files only, not the shop: stage_own_theme puts them on the shop as its draft.