@wix/agent-skills 1.19.2 → 1.20.0

package/skills/wix-headless-fast/references/storefront/app/wix/storefront/types.ts

@@ -10,14 +10,24 @@ export interface ProductSummary {
   id: string;
   slug: string;
   name: string;
-  /** Lowest price, formatted with currency symbol (e.g. "€34.99"). */
+  /**
+   * The price the buyer pays for the cheapest variant, formatted (an automatic discount already
+   * applied). When `price !== maxPrice` the product is a RANGE — render "price – maxPrice".
+   */
   price: string;
-  /** Highest price, formatted — differs from `price` when variants are priced differently. */
+  /** Highest variant price, formatted — differs from `price` when variants are priced differently. */
   maxPrice: string;
-  /** Strikethrough "was" price, formatted; null when not on sale. */
+  /**
+   * Struck "was" price, formatted; null when not on sale — and ALWAYS null for a range (a lone
+   * struck minimum beside a range claims a saving that may not apply to the variant picked).
+   */
   compareAtPrice: string | null;
-  /** Merchant-set badge ("New", "Best Seller"); null when none. */
+  /** The primary merchant ribbon ("New", "Best Seller"); null when none. Same as ribbons[0]. */
   ribbon: string | null;
+  /** EVERY merchant ribbon, primary first ("New", "Sale") — render all of them, one shared style. */
+  ribbons: string[];
+  /** The cheapest variant's id — what a direct add sends for a product with no options; null when unknown. */
+  minPriceVariantId: string | null;
   availability: Availability;
   /** OUT_OF_STOCK but pre-orderable — label "Pre-order", not "Sold out". */
   preorder: boolean;
@@ -27,6 +37,11 @@ export interface ProductSummary {
   hoverImageUrl: string;
   /** e.g. "2 colors · 3 sizes"; "" for a single-variant product. */
   optionsSummary: string;
+  /**
+   * Hex colors of a color option's visible choices, catalog order — render as small dots on the
+   * tile (a preview, not a picker: selection happens in QuickAdd or on the PDP). [] when none.
+   */
+  swatches: string[];
   /** True when the product can be added to the cart with no choices (single variant, in stock). */
   quickAddable: boolean;
 }
@@ -60,15 +75,21 @@ export interface ProductVariant {
   variantId: string;
   /** The option selections this variant answers to: optionName -> choiceName. */
   choices: Record<string, string>;
+  /** The price the buyer pays, formatted — an automatic discount beats the regular price. */
   price: string;
+  /** Struck "was" price, formatted; null unless it is real and higher than `price`. */
   compareAtPrice: string | null;
   inStock: boolean;
+  /** Out of stock but pre-orderable — still buyable (the add carries preOrderRequested). */
+  preorderEnabled: boolean;
 }
 
 /** A product as the detail page needs it. */
 export interface ProductDetail extends ProductSummary {
   /** Product description as an HTML string — render with innerHTML, not as text. */
   descriptionHtml: string;
+  /** Merchant info sections (materials, shipping, care…) — title + HTML; render as sections or accordions. */
+  infoSections: { title: string; html: string }[];
   /** Every gallery image as a resolved https URL, main image first, de-duplicated. */
   gallery: string[];
   options: ProductOption[];
@@ -80,6 +101,36 @@ export interface Category {
   id: string;
   slug: string;
   name: string;
+  /** Plain-text description when the merchant wrote one; "" otherwise. */
+  description: string;
+}
+
+export interface FacetChoice {
+  /** The option choice id — what searchCatalog({ choiceIds }) filters on. */
+  id: string;
+  name: string;
+  /** Hex color for a swatch facet; null for a text facet. */
+  colorCode: string | null;
+}
+
+/** One filterable option across the catalog (or a category): "Color" with its choices. */
+export interface Facet {
+  name: string;
+  isColor: boolean;
+  choices: FacetChoice[];
+}
+
+/** The catalog's (or category's) lowest and highest product price, as numbers in site currency — the slider's bounds. */
+export interface PriceRange {
+  min: number;
+  max: number;
+  currency: string;
+}
+
+/** What the filter panel needs beyond the product page: the facets and the price bounds of the scope. */
+export interface FacetData {
+  facets: Facet[];
+  priceRange: PriceRange | null;
 }
 
 export interface CartLine {
@@ -97,6 +148,11 @@ export interface CartLine {
   descriptionLines: string[];
   /** Not IN_STOCK → the line can't be checked out as-is. */
   status: string;
+  /**
+   * The recurring plan's terms for a subscription line — "Monthly plan · every month · 12 payments";
+   * "" for a one-time purchase. A subscription line must read as one in the cart.
+   */
+  subscription: string;
 }
 
 export interface Cart {
@@ -105,5 +161,7 @@ export interface Cart {
   itemCount: number;
   /** Formatted subtotal (after discounts) — from the cart estimate, not hand-summed. */
   subtotal: string;
+  /** Formatted CART-level discount (a coupon or cart rule) — "" when none; item discounts are already in subtotal. */
+  discount: string;
   currency: string;
 }

package/skills/wix-headless-fast/references/storefront/app-astro/layouts/SiteLayout.astro

@@ -1,12 +1,18 @@
 ---
 // The site chrome for every storefront page — THIS file (header/footer/nav) plus the @theme
 // token block in src/styles/global.css are what you brand. Keep:
-//   - the <slot name="seo-tags" /> in <head> (the product page's owner-editable SEO lands there)
+//   - the <slot name="seo-tags" /> in <head> (the product page's owner-editable SEO lands there,
+//     including the <title> — which is why ours is printed only when the slot is empty)
 //   - the global.css import (Tailwind + the design tokens every shipped component reads)
 //   - one <CartButton> in the header and one <CartDrawer> per page (both client:only —
 //     they read browser cart state and must not server-render)
+//   - category links in the nav (or your own menu/footer) — every category page reachable by
+//     a real link (`/category/<slug>`), from the live tree, so a category the owner adds later
+//     shows up with no code change
 import CartButton from "../components/storefront/CartButton";
 import CartDrawer from "../components/storefront/CartDrawer";
+import { fetchCategories } from "../wix/storefront/catalog";
+import type { Category } from "../wix/storefront/types";
 import "../styles/global.css";
 
 interface Props {
@@ -14,6 +20,15 @@ interface Props {
   description?: string;
 }
 const { title, description } = Astro.props;
+
+// Non-fatal: the chrome renders without the links if the read fails. Six in the header keeps a
+// large tree from crowding it — put the rest in a menu or the footer, but keep them linked.
+let navCategories: Category[] = [];
+try {
+  navCategories = (await fetchCategories()).slice(0, 6);
+} catch {
+  /* the shop link still reaches everything */
+}
 ---
 
 <!doctype html>
@@ -21,7 +36,8 @@ const { title, description } = Astro.props;
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>{title}</title>
+    {/* The product page's <SEO.Tags> renders the <title>; print ours only when no page filled the slot — two titles otherwise. */}
+    {!Astro.slots.has("seo-tags") && <title>{title}</title>}
     {description && <meta name="description" content={description} />}
     <slot name="seo-tags" />
   </head>
@@ -31,6 +47,9 @@ const { title, description } = Astro.props;
         <a href="/" class="text-base font-bold tracking-tight text-foreground no-underline">Brand Name</a>
         <nav class="flex items-center gap-6 text-sm">
           <a href="/shop" class="text-foreground no-underline transition-colors hover:text-muted-foreground">Shop</a>
+          {navCategories.map((c) => (
+            <a href={`/category/${c.slug}`} class="hidden text-foreground no-underline transition-colors hover:text-muted-foreground md:inline">{c.name}</a>
+          ))}
           <CartButton client:only="react" />
         </nav>
       </div>

package/skills/wix-headless-fast/references/storefront/seed/SEED.md

@@ -75,7 +75,11 @@ the shipped UI**: give at least one product a color option and put one product o
 truthfully to the business (a ceramics studio has glaze colors; a bakery doesn't).
 
 **Seeding is additive — never delete or overwrite existing content.** No cleanup, no removing
-"sample" data, no resets. If a cleanup genuinely seems needed, ask the user first.
+"sample" data, no resets. If a cleanup genuinely seems needed, ask the user first. The one
+exception is built in: the fast path passes `--fresh-site` because it created the site seconds
+earlier, and the seed then deletes the Stores install's sample products before creating yours
+(`samplesDeleted` in the result). Never pass that flag by hand against a site that existed before.
+Categories are idempotent by name too — a re-run reuses "Donuts" instead of creating a second one.
 
 **A bulk create can partially succeed.** The result carries `failures: [{ name, error }]` next
 to `products` — read it. A non-empty `failures` means those products are genuinely absent, not

package/skills/wix-headless-fast/references/storefront/seed/seed-store.mjs

@@ -1,7 +1,7 @@
 // Storefront seed — a BUILD-TIME script, never shipped in the app. Run it from the project
 // root (where wix.config.json lives) with a plan file:
 //
-//   node <SKILL_ROOT>/references/storefront/seed/seed-store.mjs plan.json
+//   node <SKILL_ROOT>/references/storefront/seed/seed-store.mjs plan.json [--fresh-site]
 //
 // It mints its own site token via the Wix CLI (the token never leaves this process), installs
 // the Wix Stores app if needed, waits for the V3 catalog, bulk-creates products (variants
@@ -331,11 +331,34 @@ async function stockOptionlessProducts(ctx, created) {
   }
 }
 
+// Existing categories by name (for idempotent reruns) — a re-run of the seed must reuse
+// "Donuts", not create a second one. Empty map on any failure (falls back to create).
+export async function queryCategoriesByNames(ctx, names) {
+  const out = new Map();
+  if (!names.length) return out;
+  try {
+    const r = await req(ctx, "/categories/v1/categories/query", {
+      body: { treeReference: { appNamespace: "@wix/stores", treeKey: null }, query: { cursorPaging: { limit: 100 } } },
+    });
+    const wanted = new Set(names);
+    for (const c of r.categories ?? []) if (wanted.has(c.name) && !out.has(c.name)) out.set(c.name, c.id);
+  } catch (e) {
+    console.error(`category name pre-check failed (creating everything): ${String(e.message).slice(0, 120)}`);
+  }
+  return out;
+}
+
 // Categories share the @wix/stores tree revision — concurrent creates 409, so: sequential.
+// Idempotent by name: a name that already exists is reused, never duplicated.
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/categories/create-category.md
 export async function createCategories(ctx, names) {
+  const existing = await queryCategoriesByNames(ctx, names);
   const out = [];
   for (const name of names) {
+    if (existing.has(name)) {
+      out.push({ id: existing.get(name), name });
+      continue;
+    }
     const r = await req(ctx, "/categories/v1/categories", {
       body: { category: { name, visible: true }, treeReference: { appNamespace: "@wix/stores", treeKey: null } },
     });
@@ -344,6 +367,24 @@ export async function createCategories(ctx, names) {
   return out;
 }
 
+// The Stores install drops sample products ("I'm a product") into every new catalog. On a site the
+// fast path JUST created nothing else can exist, so they are deleted before seeding — otherwise the
+// storefront ships with the samples between the real products. Only called with --fresh-site; a
+// seed against an existing site never deletes anything (SEED.md: seeding is additive).
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/products-v3/bulk-delete-products.md
+export async function deleteAllProducts(ctx) {
+  let deleted = 0;
+  for (let pass = 0; pass < 10; pass++) {
+    const r = await req(ctx, "/stores/v3/products/query", { body: { query: { cursorPaging: { limit: 100 } } } });
+    const ids = (r.products ?? []).map((p) => p.id).filter(Boolean);
+    if (!ids.length) break;
+    await req(ctx, "/stores/v3/bulk/products/delete", { body: { productIds: ids } });
+    deleted += ids.length;
+    if (ids.length < 100) break;
+  }
+  return deleted;
+}
+
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/categories/bulk-add-items-to-category.md
 export async function addProductsToCategories(ctx, mapping) {
   for (const [categoryId, productIds] of Object.entries(mapping)) {
@@ -421,12 +462,22 @@ async function setSiteCurrency(ctx, currency) {
  * threaded in memory. This is the default path — call it once instead of the individual
  * functions.
  */
-export async function setupStore(ctx, { products = [], categories = {}, currency } = {}) {
+export async function setupStore(ctx, { products = [], categories = {}, currency } = {}, { freshSite = false } = {}) {
   validateProducts(products);
   await installStoresApp(ctx);
   // Before any product exists: a product's price is stored in the site currency at create time,
   // so switching afterwards leaves the catalog priced in the old one.
   if (currency) await setSiteCurrency(ctx, currency);
+  // A just-created site holds only the install's sample products — clear them (never on an
+  // existing site: the flag is the fast path's, set only when it created the site itself).
+  let samplesDeleted = 0;
+  if (freshSite) {
+    try {
+      samplesDeleted = await deleteAllProducts(ctx);
+    } catch (e) {
+      console.error(`sample cleanup failed (seeding on top): ${String(e.message).slice(0, 120)}`);
+    }
+  }
 
   // Idempotent by name: an errored bulk create (429/5xx) may still have applied server-side,
   // and SKILL.md tells the agent to re-run a failed seed — creating only the names that don't
@@ -478,21 +529,23 @@ export async function setupStore(ctx, { products = [], categories = {}, currency
   // failures is part of the result, not an exception: a partial seed still leaves a usable
   // store, and the agent needs the names to report rather than silently shipping a short
   // catalog. Re-run the seed to retry them — existing names are skipped, not duplicated.
-  return { products: withNames, categories: cats, imagesAttached, failures };
+  return { products: withNames, categories: cats, imagesAttached, samplesDeleted, failures };
 }
 
 // ---- CLI entry ----------------------------------------------------------------------------------
 
 const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
 if (invokedDirectly) {
-  const planPath = process.argv[2];
+  const args = process.argv.slice(2);
+  const freshSite = args.includes("--fresh-site");
+  const planPath = args.find((a) => !a.startsWith("--"));
   if (!planPath) {
-    console.error("usage: node seed-store.mjs <plan.json>   (run from the project root)");
+    console.error("usage: node seed-store.mjs <plan.json> [--fresh-site]   (run from the project root)");
     process.exit(1);
   }
   const plan = JSON.parse(readFileSync(planPath, "utf8"));
   const ctx = makeCtx();
-  setupStore(ctx, plan)
+  setupStore(ctx, plan, { freshSite })
     .then((result) => console.log(JSON.stringify(result, null, 2)))
     .catch((e) => {
       console.error(e.message);

package/skills/wix-manage/SKILL.md

@@ -48,6 +48,9 @@ Generate an SEO content plan and read its blog post topics, or troubleshoot an e
 ### [Manage Google Search Console for a Wix Site](references/seo/manage-google-search-console.md)
 "Connect a Wix site to Google Search Console and drive its setup through the public GSC Connection and Site Readiness APIs: check connection and readiness, start the Google authorization, verify ownership, add the property, submit the sitemap, request indexing, read search performance, run URL inspection, recover a stale connection, or disconnect. The site owner authorizes in their own browser via a single-use connect URL."
 
+### [Generate AI SEO Suggestions for a Wix Site](references/seo/manage-seo-suggestions.md)
+"Generate AI-written SEO text for a Wix site through the public Tag Suggestions and Page Optimization APIs: title tag and meta description options for a page, alt text for the images of a page, store product, or blog post (one image or up to 20 per call), corrected heading levels for a page's headings, and a whole-page rewrite of title, description, headings, and body text aimed at the page's focus keyword, returned as before/after pairs. Use it when the user wants to improve, optimize, audit, or write the SEO text of a page or the homepage. Suggestions are returned for review; applying one is a separate SEO tags write."
+
 ---
 
 ## Accessibility
@@ -251,7 +254,7 @@ Buy a domain through Wix or connect one the user already owns — intent, availa
 "Creates an event with the Wix Events V3 API — the required request body, ISO-8601 date and time settings, venue/online/TBD location, RSVP vs ticketed registration, guest capacity, short vs rich-text descriptions, ticket tiers and pricing, and recurring series. Covers the exact field shapes and the API's misleading validation messages. Use when the user wants to create an event, set its date, location, description, guest limit or ticket prices, or set up a repeating event."
 
 ### [Manage Wix Events — Publishing, Cancelling, Cloning and Counting](references/events/manage-wix-events.md)
-"Operates on events that already exist with the Wix Events V3 API — publishing a draft, cancelling, deleting, cloning, updating an event's date or details, and counting events. Use when the user wants to publish or cancel an event, duplicate one, move an event's date, or count their events. Creating an event, its tickets or a recurring series is a separate recipe."
+"Operates on events that already exist with the Wix Events V3 API — finding an event by title, publishing a draft, cancelling, deleting (one or by filter), cloning, updating an event's date or details, and counting events. Use when the user wants to find, publish or cancel an event, duplicate one, move an event's date, delete events in bulk, or count their events. Creating an event, its tickets or a recurring series is a separate recipe."
 
 ---
 

package/skills/wix-manage/references/events/create-wix-event.md

@@ -56,6 +56,32 @@ curl -X POST 'https://www.wixapis.com/events/v3/events' \
 `title`, `location`, `dateAndTimeSettings` and `registration.initialType` are required. The event
 is created published (`status: "UPCOMING"`).
 
+**What comes back** — the created event under `event`; the id you need for every follow-up call is
+`event.id`:
+
+```json
+{
+  "event": {
+    "id": "<EVENT_ID>",
+    "title": "Summer Gala",
+    "slug": "summer-gala",
+    "status": "UPCOMING",
+    "location": { "name": "Grand Hall", "type": "VENUE", "locationTbd": false },
+    "dateAndTimeSettings": {
+      "startDate": "2026-09-15T19:00:00Z", "endDate": "2026-09-15T22:00:00Z",
+      "timeZoneId": "America/New_York", "recurrenceStatus": "ONE_TIME"
+    },
+    "createdDate": "...", "updatedDate": "..."
+  }
+}
+```
+
+Update, cancel, publish and clone return the same `{ "event": { ... } }`; delete returns
+`{ "eventId": "..." }`. Some fields are returned only when the request's `fields` array asks for
+them: `"DETAILS"` adds `shortDescription`, `"TEXTS"` adds `description`, `"REGISTRATION"` adds
+`registration` (including `rsvp.limit`), `"URLS"` adds `eventPageUrl`. Without `fields`, read the
+result from the top-level fields above and do not treat a missing `registration` as an error.
+
 > **Do not add `"draft": true` unless the user asked for a draft.** Draft events require the
 > `WIX_EVENTS.READ_DRAFT_EVENTS` permission, and without it every follow-up call fails `403` —
 > adding ticket definitions, querying the event, fetching it by slug, even publishing it. The
@@ -154,6 +180,26 @@ curl -X POST 'https://www.wixapis.com/events/v3/ticket-definitions' \
 | Free | `{ "fixedPrice": { "value": "0", "currency": "USD" } }` |
 | Donation, with a minimum | `{ "guestPrice": { "value": "5.00", "currency": "USD" } }` |
 
+The response is the definition under `ticketDefinition`:
+
+```json
+{
+  "ticketDefinition": {
+    "id": "<TICKET_DEFINITION_ID>",
+    "eventId": "<EVENT_ID>",
+    "revision": "1",
+    "name": "General Admission",
+    "limited": true, "initialLimit": 100, "actualLimit": 100,
+    "pricingMethod": { "fixedPrice": { "value": "25.00", "currency": "USD" } },
+    "feeType": "FEE_ADDED_AT_CHECKOUT",
+    "saleStatus": "SALE_STARTED"
+  }
+}
+```
+
+Keep `revision` — `PATCH /events/v3/ticket-definitions/{id}` requires the current value, and it
+increments on every update.
+
 - **`feeType` is required** — `FEE_ADDED_AT_CHECKOUT` or `FEE_INCLUDED`.
 - **`value` is a string.** `"value": 10` fails `400 Unexpected value for field value`.
 - **No writable `free` flag** — `pricingMethod.free` is read-only; a free ticket is a `fixedPrice`

package/skills/wix-manage/references/events/manage-wix-events.md

@@ -1,6 +1,6 @@
 ---
 name: "Manage Wix Events — Publishing, Cancelling, Cloning and Counting"
-description: "Operates on events that already exist with the Wix Events V3 API — publishing a draft, cancelling, deleting, cloning, updating an event's date or details, and counting events. Use when the user wants to publish or cancel an event, duplicate one, move an event's date, or count their events. Creating an event, its tickets or a recurring series is a separate recipe."
+description: "Operates on events that already exist with the Wix Events V3 API — finding an event by title, publishing a draft, cancelling, deleting (one or by filter), cloning, updating an event's date or details, and counting events. Use when the user wants to find, publish or cancel an event, duplicate one, move an event's date, delete events in bulk, or count their events. Creating an event, its tickets or a recurring series is a separate recipe."
 ---
 
 # Manage Wix Events — Publishing, Cancelling, Cloning and Counting
@@ -28,6 +28,36 @@ curl -X POST 'https://www.wixapis.com/apps-installer-service/v1/app-instance/ins
 `appDefId` nests under `appInstance`, not at the root — at the root it fails with
 `400 appInstance must not be empty`. See [Install Wix Apps](../app-installation/install-wix-apps.md).
 
+## Find an event
+
+Every action below takes an `eventId`. When the user names the event instead, look it up with
+`POST /events/v3/events/query` — `title` supports `$eq` and, for several names at once, `$in`; there is
+no contains match:
+
+```bash
+curl -X POST 'https://www.wixapis.com/events/v3/events/query' \
+  -H 'Content-Type: application/json' \
+  -H 'Authorization: <AUTH>' \
+  --data-binary '{
+    "query": {
+      "filter": { "title": { "$eq": "Open House" } },
+      "paging": { "limit": 100 }
+    },
+    "fields": ["DETAILS"],
+    "includeDrafts": false
+  }'
+```
+
+`filter` and `paging` are siblings under `query`; `paging` nested inside `filter` fails `400`. Matches
+come back in `events[]` with the id at `events[].id`, and `pagingMetadata.total` is the count.
+
+> **Keep `includeDrafts: false` unless the user is asking about draft events.** Setting it to `true`
+> needs `WIX_EVENTS.READ_DRAFT_EVENTS`, and a caller without it gets
+> `403 Requires WIX_EVENTS.READ_DRAFT_EVENTS permission` rather than more results — so do not flip
+> it as a precaution on an ordinary lookup, and do not probe for it and fall back. If the user does
+> want drafts and the call returns that `403`, say draft events are not readable from this
+> connection instead of answering from published events alone.
+
 ## Publish, cancel and delete
 
 | Action | Call | Resulting `status` |
@@ -35,10 +65,27 @@ curl -X POST 'https://www.wixapis.com/apps-installer-service/v1/app-instance/ins
 | Publish a draft | `POST /events/v3/events/{eventId}/publish` | `UPCOMING` |
 | Cancel | `POST /events/v3/events/{eventId}/cancel` | `CANCELED` |
 | Delete | `DELETE /events/v3/events/{eventId}` | — |
+| Delete several | `POST /events/v3/bulk/events/delete-by-filter` | — |
 
 Publish and cancel take an empty body. Publishing is irreversible — a published event cannot
 return to `DRAFT`. Cancelling closes registration but keeps the event; deleting removes it.
 
+Publish, cancel, clone and update all return `{ "event": { "id", "title", "slug", "status", ... } }`
+— the same event object [Create an Event](create-wix-event.md#create-the-event) shows in full.
+Delete returns `{ "eventId": "..." }` and the bulk delete below returns `{}`.
+
+To delete a set of events in one call, `POST /events/v3/bulk/events/delete-by-filter`:
+
+```json
+{ "filter": { "filter": { "id": { "$in": ["<EVENT_ID>", "<EVENT_ID>"] } } } }
+```
+
+The request's one field, `filter`, takes a whole query-shaped object — the same object Query Events
+takes under `query`, with the conditions under its own `filter` key — not a bare condition map. That
+is why the key appears twice: `filter.filter.<field>`. A single level,
+`{ "filter": { "id": { "$in": [...] } } }`, is not the documented shape. Resolve the ids with the
+query above first; one `DELETE` per event also works but costs a call each.
+
 > **Draft events need the `WIX_EVENTS.READ_DRAFT_EVENTS` permission.** Without it, publishing a
 > draft fails `403` — as does querying it, fetching it by slug, or adding ticket definitions to
 > it. If you hit that `403`, the event was still created; the way forward is to create events
@@ -104,6 +151,9 @@ even when the site has events, so it is not the way to answer "how many events d
 - **An invalid enum value reports as a missing one** — a value outside an enum returns
   `<field> value is required` rather than "invalid value". If a field you *did* send is reported
   as required, suspect the value, not its presence.
+- **`includeDrafts` stays `false` unless the request is about drafts** — see
+  [Find an event](#find-an-event). The `WIX_EVENTS.READ_DRAFT_EVENTS` note on the Query Events
+  reference describes the permission; it does not mean the caller has it.
 - Dates are always ISO-8601 strings, never `{seconds, nanos}`, and `timeZoneId` is required
   whenever `dateAndTimeSettings` is sent — see [Create an Event](create-wix-event.md).
 

package/skills/wix-manage/references/google-ads/manage-campaign-lifecycle.md

@@ -1,10 +1,10 @@
 ---
 name: "Manage Campaign Lifecycle"
-description: "Manages existing Google Ads campaigns on a Wix site: list/get, launch (first activation) vs resume (reactivate after a pause), pause a running campaign — optionally with a scheduled auto-resume date — update name/budget/targeting, change the daily budget, delete permanently, and read status history / change log. Use when the user wants to 'pause my Google ad', 'resume my campaign', 'stop the campaign', 'change my daily budget', 'rename the campaign', 'delete this campaign', 'list my Google Ads campaigns', or 'why did my campaign status change'. Requires an existing Google Ads account and campaign. REST base https://www.wixapis.com/google-ads/v1."
+description: "Manages existing Google Ads campaigns on a Wix site: list/get, launch (first activation) vs resume (reactivate after a pause), pause a running campaign — optionally with a scheduled auto-resume date — update name/budget/targeting, change the daily budget, delete permanently, and read status history / change log. Use when the user wants to 'pause my Google ad', 'resume my campaign', 'stop the campaign', 'change my daily budget', 'rename the campaign', 'delete this campaign', 'list my Google Ads campaigns', or 'why did my campaign status change'. Requires an existing Google Ads account and campaign. REST base https://www.wixapis.com/_serverless/pa-google/v1."
 ---
 # RECIPE: Manage Campaign Lifecycle
 
-Operate on campaigns that already exist. Base URL: `https://www.wixapis.com/google-ads/v1`; `<AUTH>` = `Authorization` header, and body calls also need `Content-Type: application/json`.
+Operate on campaigns that already exist. Base URL: `https://www.wixapis.com/_serverless/pa-google/v1`; `<AUTH>` = `Authorization` header, and body calls also need `Content-Type: application/json`.
 
 **Answer directly.** When the user asks *how* to do something, give the endpoint, an example request, and the key behavior right away — use `{campaignId}` as a placeholder rather than asking which campaign. Only pause to confirm when you are about to **execute** a launch, resume, or delete on the user's behalf (those spend money or are irreversible); explaining how never requires confirmation.
 
@@ -21,14 +21,14 @@ Operate on campaigns that already exist. Base URL: `https://www.wixapis.com/goog
 
 ```bash
 # Launch (first activation)  → status LIVE
-curl -X POST 'https://www.wixapis.com/google-ads/v1/campaigns/{campaignId}/launch' -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' -d '{}'
+curl -X POST 'https://www.wixapis.com/_serverless/pa-google/v1/campaigns/{campaignId}/launch' -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' -d '{}'
 
 # Pause a running campaign (settings + data preserved) → status PAUSED
-curl -X POST 'https://www.wixapis.com/google-ads/v1/campaigns/{campaignId}/pause' -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' \
+curl -X POST 'https://www.wixapis.com/_serverless/pa-google/v1/campaigns/{campaignId}/pause' -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' \
   -d '{ "scheduledResumeDate": "2024-04-15T08:00:00.000Z" }'
 
 # Resume a paused campaign → status LIVE
-curl -X POST 'https://www.wixapis.com/google-ads/v1/campaigns/{campaignId}/resume' -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' -d '{}'
+curl -X POST 'https://www.wixapis.com/_serverless/pa-google/v1/campaigns/{campaignId}/resume' -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' -d '{}'
 ```
 
 - **Pause** stops delivery immediately without losing configuration. Optional body fields: `scheduledResumeDate` (ISO 8601 — the campaign **auto-resumes** at that time; pass `null` to cancel a scheduled resume), `resumeReminderDate` (dashboard reminder), `turnAutoRenewOff`. Send `{}` to pause with no auto-resume. To temporarily stop a campaign, **pause it — never delete**.
@@ -39,7 +39,7 @@ curl -X POST 'https://www.wixapis.com/google-ads/v1/campaigns/{campaignId}/resum
 `PATCH /v1/campaigns/{id}` — send only the fields you're changing, plus the required `id` and `accountId`. Budget is in **micros** (`20000000` = $20.00/day).
 
 ```bash
-curl -X PATCH 'https://www.wixapis.com/google-ads/v1/campaigns/{campaignId}' -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' \
+curl -X PATCH 'https://www.wixapis.com/_serverless/pa-google/v1/campaigns/{campaignId}' -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' \
   -d '{ "campaign": { "id": "...", "accountId": "...", "name": "New name", "budget": { "amountMicros": "20000000" } } }'
 ```