add_custom_domain
ChatGPTConnect the owner's custom hostname and return the DNS records they must configure. Requires project administrator access. Pass a unique idempotency_key for this connection attempt; reuse it for retries, and use a new one after cancel/re-add. Call get_custom_domain first. Do not replace an existing domain implicitly. A root domain defaults to www as the primary hostname. Set use_www=False only when the owner explicitly requests the root hostname as primary. Present the returned DNS records exactly. The backend checks DNS automatically and enables SSL; the owner never needs to click Verify or call a validate API.
add_page
ChatGPTCreate a new page with metadata and optional SEO/custom HTML fields. Args: project_id: The project ID. name: Page display name. slug: URL slug (must be unique in the project). seo_meta_title: Optional SEO meta title. seo_meta_desc: Optional SEO meta description.
add_products_to_commerce_collection
ChatGPTLink products to a collection, skipping any already linked. Every id is validated against the store first — an unknown id fails the whole call. Args: project_id: The project ID. collection_id: The collection ID. product_ids: JSON array of product ids to link, e.g. ["abc","def"].
create_cms_category
ChatGPTCreate a new CMS post category. Name is required; slug is auto-generated from name if omitted. Thumbnail URL is fetched and uploaded to project CDN. Args: project_id: The project ID. name: Category display name (required). slug: URL slug; auto-generated from name if empty. description: Optional category description. thumbnail: Thumbnail image URL; will be uploaded to project CDN. thumbnail_title: Thumbnail title (stored in thumbnail_meta). thumbnail_alt: Thumbnail alt text (stored in thumbnail_meta). thumbnail_caption: Thumbnail caption (stored in thumbnail_meta).
create_cms_post
ChatGPTCreate a new CMS blog post. Args: project_id: The project ID. title: Post title. slug: URL-safe slug for the post. content: Post body as HTML (optional if content_blocks is set). content_blocks: JSON string of the block tree (same shape as get_cms_post data.content_blocks). If set, stored as-is and content HTML is ignored. excerpt: Short excerpt/summary shown in post listings (also flips the post to using a custom excerpt). featured_image: URL of the featured image. featured_image_alt: Alt text for the featured image (counts toward the "images with alt texts" SEO check). keyword: Focus keyword for the post. categories: Comma-separated category names/slugs (e.g. "Technology,News"). Matching categories are fetched and sent as category objects. tags: Comma-separated tags (e.g. "beginner,seo"). Tags are free-form and are created on the fly. seo_meta_title: Custom SEO <title> for search engines (defaults to the post title). Keep under 70 characters. seo_meta_desc: Custom meta description for search engines. Keep under 160 characters — drives the "meta description" SEO check.
create_commerce_collection
ChatGPTCreate a product collection, e.g. "New arrivals" or "Under $50". Only title is required. Args: project_id: The project ID. title: Collection name. Required. description: Collection description. slug: URL slug. Derived from the title if empty. image_url: Cover image URL. product_ids: JSON array of product ids to link, in display order, e.g. ["abc","def"]. status: active or draft. Draft collections are not published to the storefront. sort: Manual ordering weight; lower sorts first. seo: JSON object {title, description, image_url, canonical_url, robots}.
create_commerce_product
ChatGPTCreate a product in the store. Only title is required. Money is an integer in the currency's smallest unit: price_amount=2999 is $29.99 for USD. To sell variations, pass options here, then call generate_commerce_variants, or pass variants explicitly alongside options. Args: project_id: The project ID. title: Product name. Required. description: Long product description. slug: URL slug. Auto-generated from the title if empty. subtitle: Short line shown under the title. product_type: digital, download, course, template, membership, service, or physical. Physical forces one_time pricing. pricing_type: one_time, subscription, or pay_what_you_want. status: draft, active, or archived. Only active products show on the storefront. price_amount: Price in the smallest currency unit (e.g. cents). compare_at_amount: Struck-through reference price, same unit. currency: ISO currency code. Defaults to the store currency. image_url: Primary product image URL. image_alt: Alt text for the primary image. sku: SKU used when the product has no variants. checkout_url: External checkout link. Ignored for physical products. shipping_note: Shipping copy shown on the product page. requires_shipping: Whether checkout must collect a shipping address. weight_grams: Shipping weight in grams. inventory_enabled: Track stock for this product. inventory_quantity: Starting stock when there are no variants. highlights: JSON array of short selling-point strings (max 12). faqs: JSON array of {question, answer} objects (max 12). gallery: JSON array of {url, title, alt} image objects (max 12). delivery_details: JSON object {delivery_type, access_duration, access_note, refund_period, refund_policy}. social_proof: JSON object {rating, review_count, sales_count, sales_label}. seo: JSON object {title, description, image_url, canonical_url, robots}. discount: JSON object {code, percent_off, amount_off, expires_at, apply_mode, enabled, label}. options: JSON array of variation axes, max 3, e.g. [{"name":"Size","values":["S","M","L"]}]. variants: JSON array of variants. Each needs option_values naming every option, e.g. {"option_values":{"Size":"M"},"price_amount":2999,"sku":"TEE-M"}.
create_commerce_variant
ChatGPTAdd one variant to a product. option_values must name every one of the product's options with a value that option allows — call set_commerce_product_options first. Fails with 409 if the combination already exists. Args: project_id: The project ID. product_id: The product ID. option_values: JSON object mapping option name to value, e.g. {"Size":"M","Colour":"Black"}. sku: Variant SKU, unique within the product. price_amount: Variant price in the smallest currency unit. Leave -1 to inherit the product price. compare_at_amount: Struck-through price for this variant. Leave -1 to skip. currency: ISO currency code. Defaults to the product currency. image_url: Image shown when this variant is selected. weight_grams: Shipping weight in grams. Leave -1 to skip. requires_shipping: Whether this variant needs a shipping address. inventory_policy: deny blocks checkout at zero stock, continue allows overselling. Default deny. inventory_quantity: Starting stock for this variant. Leave -1 to skip.
create_directory_collection
ChatGPTCreate a new directory collection. Args: project_id: The project ID. name: Collection display name. slug: URL-safe slug (lowercase, hyphens, underscores only). fields: JSON array of field objects. Each field needs: type (text|richtext|image|link|datetime|switch|option|reference|map|html|multiimage|video), label. Optional: id.
create_directory_field
ChatGPTCreate a new field in a directory collection. Args: project_id: The project ID. collection_id: The collection ID. field_type: One of: text, richtext, image, link, datetime, switch, option, reference, map, html, multiimage, video. label: Display label for the field. field_id: Custom field ID (auto-generated if omitted).
create_directory_item
ChatGPTCreate a new directory item. Args: project_id: The project ID. collection_id: The collection ID. name: Item name. slug: URL-safe slug. fields: JSON object mapping field_id to value.
create_newsletter_custom_field
ChatGPTDefine a subscriber attribute before collecting it in forms. OAuth scope newsletter:write. Pass a stable idempotency_key for this intended action; reuse it on retries. Use get_newsletter_schema for document, filter and field definitions.
create_url_redirect
ChatGPTCreate a URL redirect for a project. Requires a custom domain connected to the project (redirects are only served on custom domains, not on the default *.grigora.app subdomain); otherwise the API returns a 403 error. Args: project_id: The project ID. source_path: Path to redirect from, e.g. "/old-page" (must not be "/"). dest_type: "internal" (redirect to another path on the same site) or "external" (redirect to a full URL). Defaults to "internal". dest_path: Destination path when dest_type="internal", e.g. "/new-page". dest_url: Destination URL when dest_type="external" (must start with http:// or https://), e.g. "https://example.com". status_code: HTTP redirect code: 301, 302, 303, 304, 307, or 308. Defaults to 301.
create_website
ChatGPTCreate a NEW Grigora website with AI from a description of what it should be. Grigora's AI website builder designs and writes the whole site from the prompt in the background (usually a few minutes). This uses the account's AI credits and counts toward its plan's website limit, so call it once per website the user actually asked for. The site is NOT published. Then: poll get_website_build_status(project_id) until status is "completed" (or "failed"); after that the new site's project_id works with every other tool (products, directory, blog, assets...), edit_website changes it with more prompts, and publish_project makes it live when the user wants. Give the user the returned editor_url to open the site in Grigora's editor. Args: prompt: What the website is for and what it should contain — business, audience, pages, tone, style. Specific is better. name: The website's name, e.g. "Pumpkin". Optional; derived from the prompt when empty. attachments: Optional links to files for the builder to use — logos, photos, brand guides, menus (PDF), price lists (CSV), audio, video. A list of up to 10 public URLs, e.g. ["https://example.com/logo.png"]. Grigora downloads them itself (up to 80 MB each), so only pass links — never file contents. Refer to them in the prompt by file name, e.g. "use logo.png in the header". For a LOCAL file (e.g. on the user's computer), first call get_attachment_upload_url, upload it with the returned curl command, then pass the returned url here. A refused attachment fails the call before anything is built or charged.
delete_assets
ChatGPTDelete assets (files and/or folders). Folder paths should end with /. Args: project_id: The project ID. files: JSON array of paths to delete (e.g. ["images/photo.jpg", "temp/"]).
delete_cms_category
ChatGPTDelete a CMS post category by ID. Args: project_id: The project ID. category_id: The category ID (from list response).
delete_cms_post
ChatGPTDelete a CMS blog post. Args: project_id: The project ID. post_id: The ID of the post to delete (UUID from list response, or full SK like cms-post-data-<uuid>).
delete_commerce_collection
ChatGPTDelete a collection. The products it grouped are not deleted. Args: project_id: The project ID. collection_id: The collection ID to delete.
delete_commerce_product
ChatGPTDelete a product and its stock counters. Fails with a 409 while any order referencing the product is still open — fulfil, refund, or cancel those orders first. Args: project_id: The project ID. product_id: The product ID to delete.
delete_commerce_variant
ChatGPTRemove one variant from a product and drop its stock counter. The product's options are left in place, so the combination can be re-added later. Args: project_id: The project ID. product_id: The product ID. variant_id: The variant ID to remove.
delete_directory_collection
ChatGPTDelete a directory collection and all its items. Args: project_id: The project ID. collection_id: The collection ID.
delete_directory_field
ChatGPTDelete a field from a directory collection. Args: project_id: The project ID. collection_id: The collection ID. field_id: The field ID to delete.
delete_directory_item
ChatGPTDelete a directory item. Args: project_id: The project ID. collection_id: The collection ID. item_id: The item ID to delete.
delete_url_redirect
ChatGPTDelete a URL redirect by ID. Args: project_id: The project ID. redirect_id: The redirect ID (from list_url_redirects).
edit_website
ChatGPTChange an existing AI-built Grigora website by describing the change. Grigora's AI builder applies the change to the site's design and content in the background (usually a few minutes), exactly like typing the prompt in the editor's AI chat. Uses the account's AI credits; nothing is published. Works only on AI-builder websites. Only ONE build runs per website at a time. If one is running this returns error "build_in_progress" with its build_id: wait for get_website_build_status to report "completed" (or "failed"), then send the next change. Combine related changes into one prompt when you can. If no build starts, "reply" holds the AI's question for the user. Args: project_id: The website's project ID. prompt: The change to make, e.g. "Make the hero warmer and add a testimonials section". attachments: Optional links to files for the builder to use — logos, photos, brand guides, menus (PDF), price lists (CSV), audio, video. A list of up to 10 public URLs, e.g. ["https://example.com/logo.png"]. Grigora downloads them itself (up to 80 MB each), so only pass links — never file contents. Refer to them in the prompt by file name, e.g. "use logo.png in the header". For a LOCAL file (e.g. on the user's computer), first call get_attachment_upload_url, upload it with the returned curl command, then pass the returned url here. A refused attachment fails the call before anything is built or charged.
generate_commerce_variants
ChatGPTGenerate every combination of a product's current options as variants (max 100). Existing variants are matched by option combination and keep their id, SKU, price, and stock; missing combinations are added at the product's price. Args: project_id: The project ID. product_id: The product ID.
get_analytics_umami
ChatGPTGet Umami analytics for a project (pageviews, visitors, top pages, etc.). Requires Umami connected to the project. Args: project_id: The project ID. start_date: Start date YYYY-MM-DD (optional; default last 30 days). end_date: End date YYYY-MM-DD (optional; default today). timezone: Timezone (default UTC). limit: Max number of top pages to return. unit: Time bucketing: minute, hour, day, month, year.
get_asset
ChatGPTGet a single asset by path (URL and metadata). Args: project_id: The project ID. path: Asset path relative to project (e.g. images/photo.jpg).
get_asset_upload_urls
ChatGPTGet signed upload URLs for one or more files. Upload the file with PUT to the returned upload_url; then use cdn_url to access the file. Args: project_id: The project ID. files: JSON array of filenames (e.g. ["images/photo.jpg", "doc.pdf"]). folder: Optional folder prefix for all files.
get_attachment_upload_url
ChatGPTGet a one-time upload link for a LOCAL file to attach to create_website / edit_website. MCP cannot carry files, so a local file goes straight from disk to Grigora's storage with the returned curl command (replace <LOCAL_FILE_PATH> with the file's path and run it in a shell). The file's contents never pass through the conversation. Then put the returned url in the attachments list of create_website or edit_website. The link expires in 15 minutes; one link per file. Allowed: images (PNG, JPG, WebP, GIF, AVIF), PDF, CSV (up to 10 MB), and audio/video (up to 80 MB). For a file that is already online, skip this and pass its public URL directly. Args: file_name: The file's name, e.g. "brand-guide.pdf" (refer to it by this name in the prompt). mime_type: e.g. "image/png", "application/pdf", "text/csv", "video/mp4". size_bytes: The file's exact size in bytes (e.g. from wc -c < FILE).
get_cms_post
ChatGPTGet a single CMS blog post's content as HTML and as blocks. Returns success, data.id, data.content_html (HTML string), and data.content_blocks (block tree or array; null if not parseable). Args: project_id: The project ID. post_id: The ID of the post (UUID from list response, or full SK like cms-post-data-<uuid>).
get_commerce_collection
ChatGPTGet one collection, optionally with the full product objects it links. Args: project_id: The project ID. collection_id: The collection ID. Required unless slug is given. slug: The collection slug. Used when collection_id is empty. include_products: Also return the linked products, in link order.
get_commerce_product
ChatGPTGet one product with its options, variants, live stock, and public URL. Args: project_id: The project ID. product_id: The product ID. Required unless slug is given. slug: The product slug. Used when product_id is empty.
get_commerce_settings
ChatGPTGet store settings: name, default currency, emails, appearance, SEO, shipping, tax, invoicing. Payment gateway credentials are never returned — connection status only. Args: project_id: The project ID.
get_custom_code
ChatGPTGet custom code (header, body, footer) for a project. Args: project_id: The project ID.
get_custom_domain
ChatGPTGet the connected/pending custom domain, exact DNS records and automatic check status. Read-only. DNS verification and SSL activation happen automatically in the backend. This tool does not validate or activate a domain and is safe to call for progress.
get_directory_item
ChatGPTGet a single directory item by ID. Args: project_id: The project ID. collection_id: The collection ID. item_id: The item ID.
get_newsletter_schema
ChatGPTDiscover newsletter operations, merge tags, signup fields and email document blocks. OAuth scope newsletter:read. Use get_newsletter_schema for document, filter and field definitions.
get_page
ChatGPTGet a single page by ID (metadata only; no content). Args: project_id: The project ID. page_id: The page ID.
get_project_details
ChatGPTGet details of a specific project/site. Args: project_id: The project ID.
get_seo_settings
ChatGPTRead Grigora's existing SEO settings before making SEO/schema changes. Returns data.settings, data.editable_fields (supported keys, types, enums), can_update, requires_version and ai_mutation_version. Covers person or organization identity, address, logo, phones, hours, sitemap, robots.txt and IndexNow. Site-level schema is generated by Grigora from these settings.
get_website_build_status
ChatGPTStatus of a website's AI build: running, completed, failed (or none). Use after create_website or edit_website. A build usually takes a few minutes; wait a little between checks rather than polling rapidly. When finished, "reply" is the AI builder's summary of what it did. Args: project_id: The website's project ID (from create_website or list_projects). build_id: Optional; the build_id create_website returned. Defaults to the latest build.
list_assets
ChatGPTList assets (files and folders) in the project CDN. Args: project_id: The project ID. folder: Optional folder path to list (e.g. images/ or docs/).
list_cms_categories
ChatGPTList all CMS post categories for a project. Args: project_id: The project ID.
list_cms_posts
ChatGPTList all CMS blog posts for a project. Args: project_id: The project ID.
list_commerce_collections
ChatGPTList product collections (storefront groupings) with their linked product ids. Args: project_id: The project ID. status: Filter by status: active or draft. Empty for all.
list_commerce_products
ChatGPTList products in a project's store. Args: project_id: The project ID. status: Filter by status: draft, active, or archived. Empty for all. product_type: Filter by type: digital, download, course, template, membership, service, or physical. Empty for all. collection_id: Only return products linked to this collection. Empty for all. search: Case-insensitive match against title, slug, and SKU. full: Return complete product objects instead of summaries. limit: Max products to return (default 100, max 500). offset: Number of products to skip.
list_commerce_variants
ChatGPTList a product's options and variants with live stock. Products without options report a single synthetic variant with id "default". Args: project_id: The project ID. product_id: The product ID.
list_directory_collections
ChatGPTList all directory collections for a project. Args: project_id: The project ID.
list_directory_fields
ChatGPTList all fields for a directory collection. Args: project_id: The project ID. collection_id: The collection ID.
list_directory_items
ChatGPTList all items in a directory collection. Args: project_id: The project ID. collection_id: The collection ID.
list_newsletter_custom_fields
ChatGPTRead custom field definitions for signup forms and merge tags. OAuth scope newsletter:read. Use get_newsletter_schema for document, filter and field definitions.
list_newsletter_lists
ChatGPTList newsletter audiences and IDs for signup forms; archived lists are excluded by default. OAuth scope newsletter:read. Use get_newsletter_schema for document, filter and field definitions.
list_pages
ChatGPTList all pages for a project (metadata only; each page has id, name, slug, etc.). Args: project_id: The project ID. limit: Max number of pages to return (optional; 0 = no limit). offset: Number of pages to skip (optional).
list_projects
ChatGPTList the projects (sites) this connection can work on. With an account connection this is every site the user owns or collaborates on, resolved live — call it first, then pass the chosen project's id as project_id to the other tools.
list_url_redirects
ChatGPTList all URL redirects configured for a project. Returns data.redirects (array of {id, source_path, dest_type, dest_path, dest_url, status_code, ...}) and data.custom_domain_connected (bool). A connected custom domain is required to create or edit redirects. Args: project_id: The project ID.
publish_cms_post
ChatGPTPublish a CMS blog post (make it live). Args: project_id: The project ID. post_id: The ID of the post to publish (UUID from list response, or full SK like cms-post-data-<uuid>).
publish_project
ChatGPTPublish a project to make all changes live. Args: project_id: The project ID.
remove_products_from_commerce_collection
ChatGPTUnlink products from a collection. The products themselves are not deleted. Args: project_id: The project ID. collection_id: The collection ID. product_ids: JSON array of product ids to unlink, e.g. ["abc","def"].
set_commerce_collection_products
ChatGPTReplace a collection's product list with exactly these ids, in this order. This is also how you reorder a collection. Pass [] to clear it. Args: project_id: The project ID. collection_id: The collection ID. product_ids: JSON array with the complete, ordered product id list, e.g. ["abc","def"].
set_commerce_product_options
ChatGPTSet a product's variation axes (size, colour, ...) and rebuild its variants. By default the full variant matrix is regenerated: variants matching an existing option combination keep their id, SKU, price, and stock; combinations that no longer exist are removed. Pass variants to control the set explicitly. Args: project_id: The project ID. product_id: The product ID. options: JSON array of up to 3 axes, e.g. [{"name":"Size","values":["S","M","L"]},{"name":"Colour","values":["Black","White"]}]. Send [] to remove all options and variants. variants: Optional JSON array of variants to use instead of the generated matrix.
unpublish_cms_post
ChatGPTUnpublish a CMS blog post (take it offline). Args: project_id: The project ID. post_id: The ID of the post to unpublish (UUID from list response, or full SK like cms-post-data-<uuid>).
update_cms_category
ChatGPTUpdate an existing CMS post category. Only provided fields are updated. Args: project_id: The project ID. category_id: The category ID (from list response). name: Category display name. slug: URL slug. description: Category description. thumbnail: Thumbnail image URL; will be uploaded to project CDN. thumbnail_title: Thumbnail title (updates thumbnail_meta). thumbnail_alt: Thumbnail alt text (updates thumbnail_meta). thumbnail_caption: Thumbnail caption (updates thumbnail_meta).
update_cms_post
ChatGPTUpdate an existing CMS blog post. Only the fields you pass are changed — everything else (categories, tags, excerpt, featured image, content, ...) keeps its current value. Args: project_id: The project ID. post_id: The ID of the post to update (UUID from list response, or full SK like cms-post-data-<uuid>). title: New title (leave empty to keep current). slug: New slug (leave empty to keep current). content: New content HTML (leave empty to keep current; ignored if content_blocks is set). content_blocks: JSON string of the block tree to replace post body (leave empty to keep current). excerpt: New excerpt/summary (leave empty to keep current). featured_image: New featured image URL (leave empty to keep current). featured_image_alt: New alt text for the featured image (leave empty to keep current). keyword: New focus keyword (leave empty to keep current). categories: Comma-separated category names/slugs (e.g. "Technology,News"). Replaces the post's categories; leave empty to keep current. tags: Comma-separated tags (e.g. "beginner,seo"). Replaces the post's tags; leave empty to keep current. seo_meta_title: New SEO <title> (leave empty to keep current). Keep under 70 characters. seo_meta_desc: New meta description (leave empty to keep current). Keep under 160 characters.
update_commerce_collection
ChatGPTUpdate a collection's own fields. Only the arguments you set are changed. To change which products it contains, use add_products_to_commerce_collection, remove_products_from_commerce_collection, or set_commerce_collection_products. Args: project_id: The project ID. collection_id: The collection ID. title: New collection name. description: New description. slug: New URL slug. image_url: New cover image URL. status: active or draft. sort: New ordering weight. Leave -1 to keep current. seo: JSON object, replaces the existing SEO block.
update_commerce_inventory
ChatGPTSet or adjust stock for one variant. Use quantity for an absolute level, or delta to add/subtract (negative allowed). Stock never goes below zero. Products without variations use variant_id "default". Args: project_id: The project ID. product_id: The product ID. variant_id: The variant ID. Use "default" for products with no variations. quantity: Absolute stock level. Takes precedence over delta. Leave -1 to use delta. delta: Relative change, e.g. -3 to remove three units. Must be non-zero when quantity is -1.
update_commerce_price
ChatGPTSet product and/or per-variant pricing in one call. All amounts are integers in the currency's smallest unit: 2999 is $29.99 for USD. At least one pricing argument must be supplied. Args: project_id: The project ID. product_id: The product ID. price_amount: New product price. Leave -1 to keep current. compare_at_amount: New struck-through reference price. Use 0 to clear it, -1 to keep current. currency: New ISO currency code for the product. pricing_type: one_time, subscription, or pay_what_you_want. Forced to one_time for physical products. variant_prices: JSON array of per-variant overrides, e.g. [{"variant_id":"v_abc","price_amount":3499}]. Unknown variant ids are rejected.
update_commerce_product
ChatGPTUpdate a product. Only the arguments you set are changed. Sending options or variants replaces the whole set — variants that no longer match the options are dropped along with their stock counters. Use set_commerce_product_options or the variant tools for safer, targeted edits. Args: project_id: The project ID. product_id: The product ID. Required. title: New product name. description: New description. slug: New URL slug. subtitle: New subtitle. product_type: digital, download, course, template, membership, service, or physical. pricing_type: one_time, subscription, or pay_what_you_want. status: draft, active, or archived. price_amount: New price in the smallest currency unit. Leave -1 to keep current. compare_at_amount: New struck-through price. Leave -1 to keep current. currency: New ISO currency code. image_url: New primary image URL. image_alt: New primary image alt text. sku: New SKU. checkout_url: New external checkout link. shipping_note: New shipping copy. highlights: JSON array of selling-point strings, replaces the existing list. faqs: JSON array of {question, answer}, replaces the existing list. gallery: JSON array of {url, title, alt}, replaces the existing gallery. delivery_details: JSON object, replaces the existing delivery details. social_proof: JSON object, replaces the existing social proof. seo: JSON object, replaces the existing SEO block. discount: JSON object, replaces the existing product discount. options: JSON array of variation axes, replaces all options. variants: JSON array of variants, replaces all variants.
update_commerce_settings
ChatGPTUpdate store settings, most importantly the default currency for new products. Payment gateway credentials cannot be set through this tool — connect a gateway in the Grigora dashboard. Existing connections are preserved. Args: project_id: The project ID. store_name: Store display name. currency: Default ISO currency code for new products, e.g. USD. support_email: Buyer-facing support address. notification_email: Address that receives new-order notifications. payment_provider: Which connected gateway checkout uses: external, razorpay, stripe, paypal, paddle, gumroad, or manual. storefront_base_url: Overrides the base URL used to build product and collection links. checkout_mode: Checkout strategy. Default external_first. appearance: JSON object {theme_preset, accent_color, background_color, text_color, button_style, product_layout, media_fit}. seo_defaults: JSON object of fallback SEO for product and collection pages. shipping: JSON object of shipping rates and zones. tax: JSON object of tax rules. invoice: JSON object of invoice/receipt configuration.
update_commerce_variant
ChatGPTUpdate one variant. Sibling variants are untouched. option_values cannot be changed — delete the variant and add the new combination instead. Args: project_id: The project ID. product_id: The product ID. variant_id: The variant ID (from list_commerce_variants). sku: New SKU. price_amount: New price in the smallest currency unit. Leave -1 to keep current. compare_at_amount: New struck-through price. Leave -1 to keep current. currency: New ISO currency code. image_url: New variant image URL. weight_grams: New shipping weight in grams. Leave -1 to keep current. inventory_policy: deny or continue. inventory_quantity: New stock level. Leave -1 to keep current.
update_custom_code
ChatGPTUpdate custom code (header, body, footer) for a project. At least one of header, body_code, footer, or a clear_ flag must be provided. Omitted keys (None) keep current value; pass empty string or clear_=True to clear a slot. Args: project_id: The project ID. header: Code injected into <head> (omit/None to keep current, "" to clear). body_code: Code injected at body start (omit/None to keep current, "" to clear). footer: Code injected at body end (omit/None to keep current, "" to clear). clear_body: If True, clear the body slot (body start). clear_header: If True, clear the header slot. clear_footer: If True, clear the footer slot.
update_directory_collection
ChatGPTUpdate a directory collection. Args: project_id: The project ID. collection_id: The collection ID. name: New name (leave empty to keep current). slug: New slug (leave empty to keep current).
update_directory_field
ChatGPTUpdate a field in a directory collection. Args: project_id: The project ID. collection_id: The collection ID. field_id: The field ID. label: New label (leave empty to keep current). field_type: New type (leave empty to keep current).
update_directory_item
ChatGPTUpdate a directory item. Args: project_id: The project ID. collection_id: The collection ID. item_id: The item ID. name: New name (leave empty to keep current). slug: New slug (leave empty to keep current). fields: JSON object of field values to update (leave empty to keep current).
update_newsletter_custom_field
ChatGPTUpdate a custom field label or validation options. OAuth scope newsletter:write. Pass a stable idempotency_key for this intended action; reuse it on retries. Use get_newsletter_schema for document, filter and field definitions.
update_page
ChatGPTUpdate a page's metadata: title (name), slug, SEO fields, and custom HTML. Only provided fields are updated. Slug must be unique in the project. Args: project_id: The project ID. page_id: The page ID. name: Page display name/title (leave empty to keep current). slug: URL slug (leave empty to keep current). seo_meta_title: SEO meta title (leave empty to keep current). seo_meta_desc: SEO meta description (leave empty to keep current). seo_meta_image: SEO/OG image URL or empty to keep current. no_index: Whether to set noindex for search engines (None = keep current). custom_header_html: Custom HTML in head (leave empty to keep current). custom_footer_html: Custom HTML before closing body (leave empty to keep current).
update_seo_settings
ChatGPTPatch existing platform SEO settings; omitted keys remain unchanged. Read get_seo_settings first and send only changed editable_fields. Use this for requested or necessary site SEO/schema updates instead of duplicating Grigora's Person/Organization/LocalBusiness/WebSite JSON-LD in source. Args: project_id: Current project's ID. settings: Object keyed by data.editable_fields from get_seo_settings. Identity: local_seo_enabled, local_seo_type (person/organization), local_seo_person_org_name, local_seo_website_name, local_seo_website_alternate_name, local_seo_url, local_seo_email, local_seo_logo. Address: local_seo_address_street/locality/region/ postal_code/country/format (each with the local_seo_address_ prefix), local_seo_geo_coordinates. Business: local_seo_business_type, local_seo_price_range, local_seo_opening_hours_format, local_seo_opening_hours ([{day,open,close}], HH:mm), local_seo_phone_numbers ([{type,number}]), local_seo_phone. Global: sitemap_frequency, sitemap_priority (0..1), robots_txt, bing_indexnow_api. Classic projects expose their own editable fields. Empty strings clear text; false disables a toggle; [] clears a list. Arrays replace the whole list. Never send raw JSON-LD or null. ai_mutation_version: Version from get_seo_settings, required when requires_version is true. On version conflict, reread and reconcile. idempotency_key: Unique key for this change, required when requires_version is true. Reuse the same key, settings and version after a timeout or retryable failure. Use a new key for a changed/reconciled request. Returns saved settings and publish_required. Saving does not publish the site.
update_url_redirect
ChatGPTUpdate an existing URL redirect (full replace of all fields). Requires a custom domain connected to the project; otherwise the API returns a 403 error. Args: project_id: The project ID. redirect_id: The redirect ID (from list_url_redirects). source_path: Path to redirect from, e.g. "/old-page" (must not be "/"). dest_type: "internal" or "external". Defaults to "internal". dest_path: Destination path when dest_type="internal", e.g. "/new-page". dest_url: Destination URL when dest_type="external" (must start with http:// or https://). status_code: HTTP redirect code: 301, 302, 303, 304, 307, or 308. Defaults to 301.