WebCake Storefront

Create an appointment location. Region ids are optional (Vietnamese geo ids).

Create a booking calendar = ONE employee's (technician's) working schedule. A calendar is per employee, not per service: one employee has at most one calendar per site, tied to one address. To set up staff schedules: list/create_appointment_employee → list/create_appointment_address → list/create_appointment_classify (services) → one calendar per employee with its own hours. Same hours for many staff? Create one, then duplicate_appointment_calendars and change assignee_id.

Create an appointment classify (service type).

Create an appointment employee (assignee).

Create a blog article so blog/post pages (post-list, grid-blog, post-overlay) have content. Built via the dashboard command pipeline: title + optional summary, HTML content, image URLs, and category linkage. Pass category_ids from create_blog_category / list articles' categories so the post shows up under those categories (it is also auto-filed under the default category). Image URLs must be hosted (search_images / upload_images). The backend generates the id and slug. SEO: set it afterwards with update_article({ id, seo }).

Create an automation. Checks the Automation app is installed first and installs it if needed. An automation = { name, type, status, rule }. 'rule' holds the trigger + actions (a map; shape depends on the trigger). Returns the new automation id (use it with send_mail for cms-triggered email).

Create a blog/article category. Returns the new category id — pass it to create_article's category_id so posts are grouped (post-list / blog pages bind to it). Image must be a hosted URL. SEO: set it afterwards with update_blog_category({ id, seo }).

Create a new CMS file. Types: "http_function", "jobs_config", "default"

Create a new collection (custom data TABLE). It starts with the system columns (id/inserted_at/updated_at/creator_id); pass `columns` to add custom fields. NOTE: to WRITE records into it, use an HTTP function (webcake-data: db.model(table).create({...})) — the dashboard has no direct record-insert API. See get_http_function for the SDK guide.

Create a contact entry.

Create a course linked to a product. `tracks` are lessons; `file_downloads` are attachments. Note: video tracks trigger async HLS processing. A product can only link to one course.

Create a font group (e.g. a Google Font family by URL).

Create a reusable global section (Header / Footer / shared block) the way the builder does: persists a global_section record AND embeds the same section node into page sources so it actually renders across the site (header → top of every page, footer → bottom). Build the section first with new_section (give it a real bg/padding + logo/menu/links), then pass it here. Two-step safety: dry_run=true (default) previews which pages change; dry_run=false performs the atomic save.

Create a new global source component. Component types: "cart-droppable" (cart), "popup", or any custom type.

Create a new review, edit an existing one, or post a shop reply. Omit `id` to create; include `id` to update. For a reply, set `parent_id` to the parent review id and `is_shop: true`. `product_ids` attaches the review to products (sent as product_reviews entries). `permission`: 0 = approved/shown, 1 = pending.

Create a new (empty) page. For a page with content use build_page instead. type is a KIND (main/store/member/blog/custom/error/maintain) mapped to the numeric backend type; pass seo so it doesn't publish with an empty title. ONE page per site for main (homepage) / error / maintain, and slugs are unique per site — a duplicate is refused with the existing page_id to edit instead; only 'custom' pages can be created over and over.

Create a product feed. `name` is required; slug auto-generates. Optionally pass product_conditions to auto-populate.

Create a product so the storefront has real merchandise (grid-product / slider-product bindings need this). Simple use: pass name + price (+ images, category_ids). One default variation with the price/stock is created for you. Advanced use: pass attributes (e.g. Color/Size) + variations for a multi-SKU product. Images must be HOSTED URLs — get them from search_images or upload_images first. The backend generates id, slug and publishes the product. SEO: set it afterwards with update_product({ product_id, seo }).

Create a product category (so grid-category / a category page has something to show, and products can be filed under it). Returns the new category id — pass it to create_product's category_ids. Image must be a hosted URL. SEO: set it afterwards with update_product_category({ id, seo }).

Create products from selected device-template groups (Product Design app).

Create a redirect from one path to another.

Create a saved table filter. `for_all_employees:true` shares it (needs config permission).

Create a brand-new storefront site for the current account, then (by default) switch to it and return an EMPTY, CLEAN site (no sample products/categories) ready for element composition. The backend auto-seeds off-theme sample products + categories (and a sample blog); by default this tool DELETES that seed right after creating the site (keep the non-deletable default "All" category) so you start from a blank, on-theme store. Pass keep_seed:true to keep the sample data. The site has NO pages — after this, compose a homepage from elements: get_build_guide → new_section/new_element → build_page (…

Create a NEW site from a marketplace TEMPLATE (the dedicated "use this template" API). Clones the template's pages, global sections, cart, popups, styles and fonts into a fresh site. Pick a template with semantic_search_themes / list_template_themes, then pass its theme_id here. Switches to the new site so you can immediately edit layout/content with update_page_element(s), colours/fonts via the site-style tools, then publish_site.

Create a UTM tracking link.

Add a newsletter subscriber (upsert by email or phone).

Run JS code in debug mode (without deploying). Returns execution result and console logs

Remove affiliate accounts. `payload` typically { ids: [...] }.

Remove products from the affiliate program. `payload` typically { ids: [...] }.

Delete appointment locations by id.

Delete booking calendars by id.

Delete appointment classifies by id.

Delete appointment employees by id.

Delete blog articles (soft delete — they disappear from the site)

Delete one or more automations by id.

Delete a collection (table) and all its records by id. Irreversible.

Delete contacts by id.

Delete a course by id (also deletes its tracks).

Delete multiple courses by id.

Detach/delete a custom domain from the site.

Remove employees (and any pending invitations) by site_permission id.

Delete a global section (Header/Footer/block) and remove its node from every page source. Two-step safety: dry_run=true (default) shows which pages would change; dry_run=false performs the atomic save.

Delete a global source and its published version

Delete a page

Delete product feeds by id.

Delete one or more products by id.

Delete one or more product categories by id.

Delete redirect URLs by id.

Delete (or dismiss, if not owner) a saved filter by id.

Delete UTM links by id.

Delete subscribers by id.

Duplicate booking calendars by id (creates copies).

Edit the HTTP function file by function name — best for targeted changes (fix a bug, rename, add one function). For writing multiple new functions or major refactors, use update_http_function with full content instead. Actions: - "replace_function": replace an ENTIRE function by name with new code. Server finds function boundaries automatically. - "add": append new function code at end of file. - "remove": remove a function by name. - "update_imports": replace the import block (lines before first export). Returns updated function list after edit.

Permanently delete all trashed media folders and content.

One-shot helper for filling image_alt across the site. Returns image bytes + element metadata in a single response so Claude can describe everything in one pass, then call set_image_alts once. Workflow: 1. Call this tool with scope/limit. 2. Tool returns each image inline with its element_id + source_type + source_id. 3. Claude reads images, drafts an alt for each, then calls set_image_alts(items) once with the template at the end of the response. The pre-built "items" template at the end contains placeholders — fill in "alt" and call set_image_alts.

Find a customer by ID, phone number, or email

Get all currently active promotions (is_activated=true and within start_time/end_time range)

Get the affiliate commission programs (order-level and product-level) configured for the site.

Get aggregate affiliate statistics (clicks, orders, commission, payouts) for the site.

Description is built at runtime.

Get article details by ID (includes the full HTML content)

Get the BuilderX page authoring guide: page shape, the grid layout model, styling, breakpoints, forms/data, and the build workflow. Read this before building or heavily editing a page.

Get a single product category by id (includes custom sort product ids).

Get a specific collection's details including full schema (field names, types, constraints, references) and records

Get items (products/variations) and bonus products that compose a combo. Returns combo_items (required items with count) and bonus_items (free gifts)

Get a course by id (tracks, downloads, etc.).

List members (enrolled customers) of a course.

Show current connection context: which site_id, API URL, session, and account info. Call this first to confirm you're working on the right site

Get the device-template groups for the Product Design app.

Get the full detail of an element type: category, container flag, summary, an ATTRIBUTES reference (the meaningful specials/config keys + their purpose/allowed values, events, and dataset binding targets), and a live skeleton node (the authoritative default shape) you can copy and edit. Read this before authoring/editing an element so you set the right keys.

Get the site's transactional email templates (order confirmation, receipt, shop notice).

View version history of a CMS file. Each version includes its saved content — to restore, pass that content back to update_http_function (the http_function file) or update_cms_file, or use restore_file_version.

Get one global section as a COMPACT tree (3-5x fewer tokens than raw JSON). Each line: ID [type] "text" .class [Nbind] [Nev] (children_count). Use this to learn how a real Header/Footer/block is composed before building your own.

Get full detail (style, config, specials, events, bindings, responsive bp1..bp4, children IDs) of a single element inside a global section.

Get multilingual contents for global sources by component type

Get full detail of a global source — compact tree view showing all elements. Each line: ID [type] "text" .class [events] [bindings] (children_count). Provide component for faster lookup; omit if you already called list_global_sources.

Get full detail of a single element (style, config, specials, events, bindings, responsive, children).

Get the main HTTP function file. Choose the right mode for your task: - overview=true: function names + line ranges only, NO code body. Use for: browsing, understanding structure, finding which function to read. - overview=false (DEFAULT): full code + collection schemas. Use for: writing new features, refactoring, understanding full context. Tip: for small fixes, use overview first then get_http_function_snippet to read just that function. Add include_guide=true on first call to get the coding guide

Read specific function(s) by name. Much more token-efficient than reading the full file

Get analytics insight over a time range (defaults to last 7 days on the UI).

Get today's insight snapshot (orders, customers, conversion).

Get the INTAKE questionnaire + build flow to run BEFORE creating a new site/store/page. Call this at the start of any fresh build: ask the user this one short batch (plain words, with defaults), restate the plan, get a yes, THEN build. Skip only for tiny edits, data questions, or when the user already gave the brief / says 'just do it'.

Get media storage capacity/usage for the site.

Get full order details by ID: customer info, items, payment, shipping, discounts, etc.

Inspect a local page draft: its meta, the section ids, total section count, and (if a commit is in progress) the page_id + committed_count.

Get full detail of a single element by its ID (e.g. 'TEXT-3', 'BUTTON-1', 'SECTION-2'). Returns style, config, specials, events, bindings, responsive, and children IDs

Get the authoritative JSON Schema (Draft 2020-12) for a page source `{ sections: [...] }` — the structural contract for every node (id/type/specials/runtime{style,config}/children/events/bindings) in the CSS-grid model. Use it as the shape to emit; validate_page enforces the semantic rules.

Get page source overview: section count, element type counts, and all custom CSS classes. Use this first, then use search_page_elements to find specific elements

View version history of a page

Get the per-variation print/design templates for a product (PPD app).

Get the "contact for price" config. type 1 = applied to products, 2 = applied to categories.

Get full product details by ID: name, description, price, variations, images, attributes, SEO, etc.

Get the product measurement-unit tree (units with exchange values).

Get full promotion details by ID: name, type, schedule, discount rules, coupon settings, items, bonus products, etc.

Get products/variations/categories attached to a promotion. Returns items with discount details (fixed_prices, level_info, coupon_item_info)

Get the site's PWA configuration (manifest + iOS icon).

Get one review (with its replies / nested data) by id.

List the products a review is attached to (by review id).

Get the site's shipping configuration (zones, fees, adjustments).

Get custom code of the site (CSS/JS). Two modes: - Default: returns ALL 4 code fields (full content) - With field filter: returns only the specified field(s) — saves tokens when you only need CSS or JS Add include_guide=true on first call to get the coding guide

Get full site information: name, domain, settings (colors, typography, layout, language, payment methods, etc.) and preview_img — the latest homepage screenshots (1920_1080 desktop / 430_932 mobile), refreshed after publish_site.

Description is built at runtime.

Get all cart global sources with compact tree view. Shows full element hierarchy — no need to call get_global_source_detail separately.

Get a single product variation by its id.

Parse reference HTML into a structural blueprint (title, headings, paragraphs, images, buttons, colour palette) you can rebuild as BuilderX sections with new_section. Not a 1:1 clone.

Fetch a public URL and parse it into a structural blueprint (see ingest_html). Note: client-rendered (React/Vue) pages may return little content.

Description is built at runtime.

Invite an employee to the site by email.

Run a READ-ONLY WebCake tool (list_*/get_*/search_*/count_*… — annotations.readOnlyHint in search_tools) by exact name with its arguments. Prefer this over invoke_tool for lookups. Refuses tools that change data.

Run any WebCake tool by exact name with its arguments (discover names + schemas via search_tools). Arguments are validated before running. For read-only tools prefer invoke_read_tool.

List affiliate accounts (registered affiliates / referrers).

List affiliate-attributed orders (referrals that converted).

List affiliate payout requests/records.

List products enrolled in the affiliate program (with their commission settings).

List the site's API keys.

List appointment locations/addresses.

List booking calendars (services with availability rules) for the current site.

List appointment classifies (service categories/types).

List appointment employees (people that appointments can be assigned to).

List booked appointments for the current site.

Description is built at runtime.

List blog articles (metadata only, without HTML content). Use get_article for the full content. Pass term to search by title/slug. Pass category_id to list the posts filed under one blog category — that view is the public one, so hidden posts and posts scheduled in the future are left out.

List the site's automations so you can find an automation_id (e.g. to call send_mail, or to trigger from an HTTP function via @webcake/app/automation sendMail). Returns each automation's id, name, status and trigger info. Filter with 'term'. The id is what send_mail / the cms automation flow needs.

List every dynamic-data BINDING target: the datasets (product, cart_item, order, order_item, post, category, customer, customer_address, …) and their exact field names ('product::product_price', …), which page type each needs (store/member/blog), and how repeater children (grid-product, cart-items, post-list) bind per-item. Attach via new_element opts.bindings (ids auto-minted, e.g. opts.bindings=[{ target:'product::product_price' }]).

List blocked phone numbers (e.g. blacklisted customers).

List the large results currently held in the session cache (id, label, size, age).

List all product categories of the site

List all CMS files (HTTP functions, cron jobs, ...) for the site

List all database collections (tables) for the site. Returns collection names, table names, and field counts. Use get_collection for full schema details

List all combo/bundle products of the site. Use get_combo_items for combo composition details

List contact-form submissions.

List courses (Course app).

List customer tags for the site.

List/search the site's customers (browse or segment). Pass `term` to search by name/phone/email. Returns name, phone, email, order_count, purchased_amount, reward_point, tags, last_order_at. Use find_customer for an exact id/phone/email lookup.

List custom domains attached to the site (plus the free subdomain).

List all BuilderX element/component types you can place on a page, grouped by category with a one-line summary and whether each is a container.

List the site's employees (team members with permissions).

List the activity/change logs for a specific entity (e.g. an order). Requires the entity id and type.

List every interaction EVENT you can attach to a node: the triggers (eventName: click/hover/success/submit/…) and the actions (open_page, scroll_to, toggle, open_popup, add_to_cart, buy_now, phone_call, open_link, …) with the exact extra fields each action needs. Attach via new_element/new_section opts.events (ids are auto-minted, e.g. opts.events=[{ action:'add_to_cart', open_page:'cart' }]).

List font groups (font families with weights).

List the site's uploaded/added fonts.

List reusable global sections (Header, Footer, shared content blocks) — SLIM summary only. Each entry: id, name, slot (header/footer/block), element count + type histogram + custom classes. The full element tree is large, so it is NOT returned here — drill in with get_global_section (compact tree), search_global_section_elements, or get_global_section_element.

List global sources (cart, popup, etc.). Returns compact summary per source. Always provide component to filter by type — the API may not return all types without a filter.

List the Google Merchant records linked to the site (read-only).

Find all image elements across pages + global sources, with element_id, current alt, src, and the field path where alt is/should be written. Use as the first step before generating alt text via vision (read_image) and writing back with set_image_alts. Note: global_sections are read-only via the API and are not included.

List site invitations for the current account.

List product materials for the site.

List folders and content together in one call.

List media-library content (images/videos/files), optionally filtered by folder.

List media-library folders (optionally under a parent folder).

List the current account's PERSONAL sites (team sites are not included). Use this to find a site_id before switching. filter: "all" = active sites (default), "removed" = sites in trash. Each site has status, published_at (set at creation — not proof of publishing), slug, primary domain and has_custom_domain (verified, live, non-default domain). For plans use get_site_subscription / count_my_sites.

List notifications for the current account.

List orders of the site (metadata only). Use get_order for full details including items

List multi-language contents (translations) of the site's pages and global sections. Pass page_id + language_code to read one page's translation.

List local page drafts for the current site (summaries only: id, name, slug, type, section count, commit progress, updated_at).

List all pages of the site (metadata only, without source)

List the products inside a specific product feed.

List product feeds for sale channels (Google Shopping, Facebook, etc.).

List the plan catalog (gói cước): id, name, description, attributes. Plan names are free text, not an enum.

List Personal Product Design assignments (products enabled for personalization).

List product brand tags for the site.

List product supplier tags for the site.

List product tags (paginated, searchable by name).

List products of the site (metadata only: id, name, slug, price, image, status). Use get_product for full details

List ALL promotions/discounts of the site (every page is fetched for you). Each row has id, name, type, is_activated, pos_id (non-null = linked/synced with POS), start/end time. The summary answers "how many promotions / how many synced with POS / how many active" in ONE call — do not call get_promotion per row for that. Use get_promotion only for one promotion's full rules.

List the site's publish history (past publishes).

List SEO redirect URLs (301 redirects) for the site.

List product reviews (admin view) for the current site. Requires the product_review app installed. `permission` filters by moderation state (0 = approved/shown, 1 = pending). `sort_by`: "latest" | "oldest".

List ribbons (product sale badges) for the site.

List saved table filters for a given table (e.g. 'orders', 'products').

Browse the designer-made section library (the editor's template picker): ready, styled blocks (hero, product showcase, testimonials, footer…) to start from instead of composing from scratch. No args → categories. With category_id and/or term → templates { id, name, thumbnail, kind }. Look at a thumbnail with invoke_tool('read_image', { url }), then insert a kind:"section" template with add_section({ page_id, template:{ category_id, id } }) and restyle it to the brand.

List marketing UTM links (with view/order stats over the time window).

List newsletter subscribers.

Search/list the public Webcake template marketplace (api.storecake.io). Use to match customer brief against existing templates by keyword. Returns id, name, preview_url, thumbnail, categories

List all custom themes of the site. Returns theme name, colors, typographies, transitions, and which one is active

List every WebCake tool group, how many tools it has, and whether it is loaded natively or reached on-demand via search_tools + invoke_tool.

List translations for a resource type in a target language. Resources: product, combo_product, product_attribute, category, ribbon, article, article_category, promotion, page_name, site, notification. 'notification' takes no language filter; 'site' returns a flat key→value object.

Mark a notification as read.

Approve or hide reviews (change moderation status). `permission`: 0 = approved/shown, 1 = pending/hidden.

Build a single structurally-valid element node from the real builder factory. Returns the node — edit its specials/style, then place it in a section's children.

Return an empty but valid page source: { sections: [] }. Add sections built with new_section, then save with build_page.

Build a multi-column ROW container: children laid out SIDE BY SIDE (not stacked). This is how real pages build feature cards, category tiles, footer columns, a 2-col hero, etc. The row is RESPONSIVE — it auto-collapses to fewer columns on tablet/mobile (default tablet 2, mobile 1) so cards never become cramped slivers. Place the returned node as a child inside a section (section children still stack vertically; nest a row for horizontal layout). Example children: [{ "type":"container", "children":[{"type":"image","opts":{...}},{"type":"text","opts":{...}}] }, { ... }, { ... }]

Build a complete section node with children laid out in the builder's vertical grid. Pass an array of element specs; each child is stacked top-to-bottom. Nest containers via the child's own 'children'. Example children: [{ "type":"text", "opts":{"text":"Welcome","style":{"fontSize":"40px"}} }, { "type":"button", "opts":{"text":"Shop now"} }]

Publish the whole site live — snapshots all current page sources into the live (published) version. Note: BuilderX publishes at the SITE level, not per page; publishing makes every saved page go live. Two-step safety: dry_run=true (default) describes what will happen; dry_run=false actually publishes.

Query records from a collection (custom data table) by table name. Supports paging + an optional `where` filter and `order_by` sort. (Uses the CMS api-key auth the records endpoint requires.)

Read a slice of a large cached result produced by another tool (look for "cached":true + a cache_id in its output). Page through with offset/length; the response reports next_offset + remaining_chars until done.

Fetch an image URL and return its bytes for vision analysis by the AI client. Pair with scan_unique_images to inspect images already on the site. After receiving the image, describe it (subject, style, palette, composition, mood, lighting, background, notable_details) to build an image-generation brief. Describe the image with these fields, useful as input for new image generation: - subject: main object / scene / person - style: photography, illustration, 3D render, flat vector, watercolor, ... - palette: 3–5 dominant colors (hex or names) - composition: layout, framing, focal point - mood:…

Batch fetch multiple image URLs in parallel. Use when comparing several references or extracting motifs across a set. Capped at 5 images per call to keep context manageable. For each image, describe subject/style/palette/composition/mood; then synthesize common themes for the brief. Describe the image with these fields, useful as input for new image generation: - subject: main object / scene / person - style: photography, illustration, 3D render, flat vector, watercolor, ... - palette: 3–5 dominant colors (hex or names) - composition: layout, framing, focal point - mood: emotion or atmosphere…

Refuse a site invitation.

Remove a font by id.

Remove a font group by id.

Disable Personal Product Design for the given ids.

Delete one or more reviews by id.

Rename the site (display name).

Roll a CMS file back to a saved version in one step: reads the version's content and writes it back to the file. Omit version_id to restore the most recent snapshot. Tip: save_file_version on the current content first if you want an undo point.

Run a deployed HTTP function. function_name excludes method prefix. Example: "get_Products" → function_name="Products", method="GET"

Create/update the transactional email templates. Each block is { title, content, status }.

Save a version snapshot of a CMS file for rollback

Save translations for a resource type in a target language. Resources: product, combo_product, product_attribute, category, ribbon, article, article_category, promotion, page_name, site, notification. For most resources `items` is an array of translation rows. For 'site' pass the translations object (key→value). For 'notification' pass an array of { key, value } and language_code is ignored.

Scan all images used across page sources, global sources, and global sections. Returns a unique list of image URLs with which elements use each one. Useful for: image audit, finding broken/duplicated CDN URLs, bulk replace planning, theme migration. Scans every string field in the source tree (config.src, style.background-image, etc.) and CSS url(...) refs — wide net catches all variants.

Search/filter elements within a global section (Header/Footer/block) without dumping the whole tree. Filter by type, id substring, custom_class, text, or has_bind / has_events / has_custom_class.

Search/filter elements within a global source. No component param needed. Examples: - Find all buttons: type="button" - Find by class: custom_class="hero" - Find text: text="subscribe" - Data-bound only: has_bind=true - With events: has_events=true - With custom class: has_custom_class=true

Search stock photos (Pexels) for a page/product. IMPORTANT: the storefront only renders images served from the WebCake CDN (image domains are whitelisted) — raw Pexels URLs will NOT display. By default this re-hosts each result on the WebCake CDN and returns a ready-to-use cdn_url (cached, so repeats are free). Use cdn_url for image src / product images. Requires the PEXELS_API_KEY environment variable.

Search/filter elements within a page source. Returns matching elements with full detail (id, type, style, text, classes, etc.). Examples: - Find all buttons: type="button" - Find elements with custom class: custom_class="hero" - Find text containing "subscribe": text="subscribe" - Find all data-bound elements: has_bind=true - Find all elements with events: has_events=true - Find all elements with custom CSS classes: has_custom_class=true

Search products by keyword. Returns matching products with basic info

Search/filter ALL promotions (every page): by keyword, type, time status (coming_soon/in_progress/finished), active flag. Rows carry pos_id (non-null = synced with POS)

Find WebCake tools by keyword across the FULL catalog — including capabilities NOT loaded natively (marketing/CRM, translations, media, appointments, affiliate, reviews, domains/SEO/shipping, brands/tags/ribbons, courses, sale channels, automation…). Returns name, group, description and JSON input schema. Then run one with invoke_read_tool (read-only) or invoke_tool.

Semantic search across the theme marketplace using bge-m3 embeddings (cosine similarity). Use when the brief is a natural-language description of industry + features (e.g. 'website mỹ phẩm có popup minigame và loyalty'), not just keywords. Returns top matches with theme_id, score, name, preview_url, thumbnail, description_vi/en

Trigger a CMS automation to send an email (same endpoint @webcake/app/automation sendMail uses). Requires the automation_id — get it from list_automations. 'data' is the payload passed to that automation/email template.

Change which enabled language is the site default.

Batch-write alt text for image elements across pages + global sources. Groups updates by source so each source is fetched + saved exactly once. Workflow: list_image_elements → read_image (per src) → describe → set_image_alts(items). If alt_path is omitted, it is auto-detected via the same probe used by list_image_elements (config.image.alt → config.alt → specials.alt).

Publish or unpublish one or more products quickly (without a full update).

Set the SEO ("Cài đặt SEO") of ONE item's translation in a target language — product, article, product category or blog category. Same fields as the item's own seo param; merged into that translation's existing SEO tags (fields you don't pass are kept). Only meta_tags is written, so the translated name/slug/content are untouched; the translation row is created if missing.

Start a page draft (no network). Build a multi-section page safely: cache each section with add_draft_section, then commit_page_draft persists it to the backend INCREMENTALLY (resumable on timeout). Use this instead of build_page for large/multi-section pages. The draft cache is DISPOSABLE (Redis on the remote server when REDIS_URL is set, in-memory otherwise; sliding ~2h TTL) — if a draft is ever lost, just re-send the sections, never a failure. ONE page per site for type main (homepage) / error / maintain, and slugs are unique per site: the draft is refused up-front with the existing page_id…

Switch to a different site by site_id. All subsequent tool calls will target the new site. The choice is saved to local database — next session will auto-connect to this site. Use list_my_sites first to find the site_id

Publish/sync a feed's products to its destination channel.

Toggle update confirmation mode. Controls whether update tools ask for user confirmation before saving. - "always_confirm" (default): Shows diff first, requires user approval before saving. Safer. - "auto_apply": Applies changes immediately without preview. Faster but riskier. Current mode is saved to database and persists across sessions. Call this tool when the user says things like: → "tự động xác nhận" / "auto confirm" / "không cần hỏi" / "don't ask" / "apply directly" → mode: "auto_apply" → "hỏi trước khi lưu" / "luôn hỏi" / "always ask" / "confirm before saving" / "xác nhận trước" → mod…

Toggle debug render mode for a CMS file

Remove all blocked customer phone numbers for the site.

Uninstall (remove) an installed application from the current site. Pass the app's subscription id — get it from list_apps (the `id` field) or get_app.

Update an affiliate account (e.g. commission rate, status). `payload` is the account object incl. its id.

Create/update the order-level affiliate commission program. `payload` is the program object (e.g. { "is_activated": true, "commission_type": ..., "commission_value": ... }).

Update the status of affiliate payout(s). `payload` typically { ids: [...], status: <code> }.

Create/update the product-level affiliate commission program. `payload` is the program object.

Update an installed app's configuration. Pass the app subscription id and an `attrs` object that is merged onto the subscription — usually `{ settings: {...} }`, optionally `{ status }`. For the product-review app, prefer update_app_review (it also propagates shop_info).

Update the product-review app's settings (e.g. shop_info, auto-approve, display options). Pass the review app's subscription id (get_app with type "product_review") and the full `settings` object.

Update an appointment location. Pass `id` plus fields to change.

Update a booking calendar (an employee's schedule). Pass `id` plus any fields to change, same shape as create_appointment_calendar. config_weekdays / config_days REPLACE the whole list — to add one day-off, read the calendar (list_appointment_calendars), append, and send the full config_days.

Update an appointment classify. Pass `id` plus fields to change.

Update an appointment employee. Pass `id` plus fields to change.

Update a blog article. Only the fields you pass are changed — each one becomes a command in the same dashboard pipeline create_article uses. NOTE: renaming regenerates the slug, so pass slug in the SAME call if you want a custom one (it is applied after the rename).

Update authentication credentials. All values are saved to local database — next session auto-restores them. Get token and session_id from browser DevTools → Network tab → copy from any API request headers

Update an automation by id. Pass only the fields to change (name, description, type, status, rule).

Update a blog/article category (name, description, image, slug, SEO). Pass id + fields to change.

Update the code content of an existing CMS file

Add or change a collection's custom columns. Reads the current schema, then PATCHes it with the system columns + your custom columns (the PATCH replaces the whole schema, so omitting a column drops it).

Update a course by id (partial). Pass `id` plus fields to change.

Update a domain (rename or advanced settings such as redirect/SSL).

Change an employee's permission bitmask. Cannot change self or owner.

Replace full source of a global source. IMPORTANT: Before calling this tool, you MUST: 1. Read existing source with get_global_source_detail first 2. Show the user what will change and get explicit confirmation 3. NEVER call without user approval — this replaces the ENTIRE source Safeguarded: blocks if new source is <50% of existing size. For element-level changes, prefer update_global_source_element instead.

Update multilingual contents (upsert). Each entry: global_source_id, language_code, content. IMPORTANT: Before calling, you MUST read existing contents with get_global_source_contents first, then show the user what will change and get explicit confirmation. NEVER update without user approval.

Update a single element within a global source. Two-step process: STEP 1: Call with dry_run=true (default) → returns diff of what will change. STEP 2: Show the diff to the user and ask for confirmation. NEVER proceed without explicit user approval. STEP 3: Only after user confirms, call again with dry_run=false to apply. IMPORTANT: You MUST show the diff to the user and get explicit "yes/ok/confirm" before calling with dry_run=false. Skipping confirmation risks data loss. Merge rules: style/config/specials = shallow merge, responsive = merge by bp key. events/bindings = REPLACE the whole array…

Batch update multiple elements in one global source. Two-step process: STEP 1: Call with dry_run=true (default) → returns per-element diff. STEP 2: Show all diffs to the user and ask for confirmation. NEVER proceed without explicit user approval. STEP 3: Only after user confirms, call again with dry_run=false to apply. IMPORTANT: You MUST show the diff to the user and get explicit "yes/ok/confirm" before calling with dry_run=false. Skipping confirmation risks data loss. Same merge rules: style/config/specials = shallow merge, events/bindings = replace.

Write the FULL HTTP function file content. Best for: writing new features, major refactors, or changes that touch multiple functions. For small targeted edits (fix one function, add one function), use edit_http_function instead. After update, auto-deploys to the bundle service

Update a media content item (rename, move, or trash). Pass `id` plus fields.

Update a media folder (rename, move, or trash). Pass `id` plus fields.

Update page properties: name, slug, homepage, SEO ("Cài đặt SEO") and settings. seo / settings are MERGED into the page's current settings — fields you don't pass are kept.

Create/update page content for a specific language. IMPORTANT: Before calling, you MUST read existing content with list_page_contents first, then show the user what will change and get explicit confirmation. NEVER update without user approval.

Update properties of a specific element in page source. Two-step process: STEP 1: Call with dry_run=true (default) → returns diff of what will change. STEP 2: Show the diff to the user and ask for confirmation. NEVER proceed without explicit user approval. STEP 3: Only after user confirms, call again with dry_run=false to apply. IMPORTANT: You MUST show the diff to the user and get explicit "yes/ok/confirm" before calling with dry_run=false. Skipping confirmation risks data loss. Merge rules: style/config/specials = shallow merge, responsive = merge by bp key. events/bindings = REPLACE the who…

Batch update multiple elements in one page. Two-step process: STEP 1: Call with dry_run=true (default) → returns per-element diff. STEP 2: Show all diffs to the user and ask for confirmation. NEVER proceed without explicit user approval. STEP 3: Only after user confirms, call again with dry_run=false to apply. IMPORTANT: You MUST show the diff to the user and get explicit "yes/ok/confirm" before calling with dry_run=false. Skipping confirmation risks data loss. Same merge rules: style/config/specials = shallow merge, events/bindings = replace.

Directly update the full page source JSON. IMPORTANT: Before calling this tool, you MUST: 1. Read existing source with get_page_source first 2. Show the user what will change and get explicit confirmation 3. NEVER call without user approval — this replaces the ENTIRE page source Safeguarded: blocks if new source is <50% of existing size.

Update a product feed. `partner_feed.id` must match `partner_feed_id`.

Set which products/categories are "contact for price" (full replace within the given type). type 1 → pass product_ids; type 2 → pass category_ids.

Update an existing product. Pass product_id + only the fields to change. To change price/stock, pass variations (get_product first to see the existing variation shape). Images must be hosted CDN urls (search_images cdn_url / upload_images).

Update a product category (name, image, description, visibility, SEO). Pass id + fields to change.

Upsert product measurement units (full list). Each unit upserts by id; pass is_removed:true to delete one.

Update the PWA manifest (the full manifest object replaces the existing one).

Update a redirect URL. Pass `is_deleted:true` to disable it.

Update a saved filter by id.

Update shipping config. Pass `idx` (the shipping record id) plus the fields to change (urban/suburban/area_shipping/adjust_price/shipping_unit/rank_priority).

Update custom code (CSS/JS) for the entire site. Only sends fields you specify — others remain unchanged. IMPORTANT: Before calling, you MUST read existing code with get_site_custom_code first, then show the user what will change and get explicit confirmation. NEVER update without user approval. - code_before_head: HTML/script inserted before </head> - code_before_body: HTML/script inserted before </body> - code_custom_css: Custom CSS (auto-wrapped in <style>) - code_custom_javascript: Custom JavaScript

Update general site settings. The `settings` object is shallow-merged onto existing settings; other top-level keys (currency, slugs, is_maintenance, robot_txt, …) replace directly.

Change the site's slug (subdomain). Fails if the slug is already taken.

Update a UTM link. Pass `id` plus fields to change.

Convert external image URLs, data: URIs, or LOCAL FILE PATHS into site-hosted CDN URLs by reading/downloading each image and re-uploading it to the WebCake backend. Use this whenever the user supplies their OWN images (their URLs or files from their machine), or a page is built from a reference HTML/URL. The returned CDN URLs go straight into an image element's specials.src / runtime.config.src, or a product/category image. This is REQUIRED for any external image (incl. Pexels search results) because the storefront only renders whitelisted WebCake-CDN image domains. Results are cached per site…

Upload an image to the media library from a base64 data URI. Returns the CDN URL.

Enroll/update a product in the affiliate program with its own commission. `payload` includes the product id and commission fields (e.g. { "product_id": "...", "commission_type": ..., "commission_value": ... }).

Create or update a customer tag. Omit `id` to create.

Create or update a product material. Supports nesting via parent_id. Omit `id` to create; `is_removed:true` to delete.

Enable/update Personal Product Design for products (bulk).

Create or update a product brand. Omit `id` to create; pass `is_removed:true` with an `id` to delete.

Create or update a product supplier. Omit `id` to create; `is_removed:true` to delete.

Create or update a product tag. Omit `id` to create; `is_removed:true` to delete (also detaches from products).

Create or update a ribbon (sale badge). `type` and `name` are unique per site. Omit `id` to create; `is_removed:true` to delete.

Validate a page source ({ sections: [...] }). Returns errors (block saving: duplicate/missing ids, missing types) and warnings (unknown types, form fields without field_name, dangling event targets) plus stats. Always run this before build_page.

Run DNS verification for a domain and enqueue SSL issuance.