@wix/agent-skills 1.19.2 → 1.20.1

package/skills/wix-headless-fast/references/storefront/rest/catalog.ts

@@ -0,0 +1,123 @@
+// Catalog reads over REST — the twin of app/wix/storefront/catalog.ts. Same exports, same DTOs; the
+// rules and mappers come from catalog-core (the SAME file the SDK transport uses, deployed flat next
+// to this one by deploy.mjs --stack static), so this file is only the transport: one fetch with a
+// literal body per function. Every call here is safe from a
+// browser with a visitor token. Porting: keep the paths, keep the bodies, port the core once.
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/products-v3/search-products.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/categories/get-category-by-slug.md
+import { WixApiError, wixRequest } from "./client.js";
+import { imgSrc, mediaKey } from "./media.js";
+import {
+  CATALOG_SORTS,
+  DETAIL_FIELDS,
+  LIST_FIELDS,
+  catalogFilter,
+  resolveVariant,
+  searchQuery,
+  sellingPrice,
+  toCategory,
+  toDetail,
+  toFacetData,
+  toSummary,
+  type CatalogSearchOptions,
+  type CatalogSort,
+  type Raw,
+} from "./catalog-core.js";
+import type { Category, FacetData, ProductDetail, ProductSummary } from "./types.js";
+
+export { CATALOG_SORTS, resolveVariant, sellingPrice, type CatalogSearchOptions, type CatalogSort };
+
+const STORES_TREE = { appNamespace: "@wix/stores", treeKey: null };
+const notFound = (e: unknown): boolean => e instanceof WixApiError && e.status === 404;
+
+/**
+ * The gallery query: sort, filter, facets, search, and cursor paging, all applied by Wix across the
+ * whole catalog — never on a page already in hand. `total` is issued with the first page only.
+ * POST /stores/v3/products/search  { fields, search: { filter, sort, search, cursorPaging } }
+ */
+export async function searchCatalog(o: CatalogSearchOptions = {}): Promise<{ products: ProductSummary[]; nextCursor: string | null; total: number | null }> {
+  const search = searchQuery(o);
+  const res = await wixRequest<Raw>("/stores/v3/products/search", { body: { fields: LIST_FIELDS, search } });
+  let total: number | null = null;
+  if (!o.cursor) {
+    try {
+      const c = await wixRequest<Raw>("/stores/v3/products/count", { body: { filter: search.filter } });
+      total = typeof c?.count === "number" ? c.count : null;
+    } catch {
+      /* the count is a nicety — the page is still valid */
+    }
+  }
+  return {
+    products: ((res?.products ?? []) as Raw[]).map((p) => toSummary(p, imgSrc, mediaKey)),
+    nextCursor: res?.pagingMetadata?.cursors?.next ?? null,
+    total,
+  };
+}
+
+/** Facets and price bounds of a scope from one 100-product read. Non-fatal: empty on failure. */
+export async function fetchFacetData({ categoryId }: { categoryId?: string | null } = {}): Promise<FacetData> {
+  try {
+    const res = await wixRequest<Raw>("/stores/v3/products/search", {
+      body: { fields: ["CURRENCY"], search: { filter: catalogFilter({ categoryId }), cursorPaging: { limit: 100 } } },
+    });
+    return toFacetData((res?.products ?? []) as Raw[]);
+  } catch {
+    return { facets: [], priceRange: null };
+  }
+}
+
+export async function fetchProducts({ limit = 24 } = {}): Promise<ProductSummary[]> {
+  return (await searchCatalog({ limit })).products;
+}
+
+export async function fetchProductsByCategory(categoryId: string, { limit = 24 } = {}): Promise<ProductSummary[]> {
+  return (await searchCatalog({ limit, categoryId })).products;
+}
+
+/**
+ * One complete product for the PDP; null when the slug doesn't resolve — a real 404, never a
+ * fallback to another product.  GET /stores/v3/products/slug/{slug}?fields=…&fields=…
+ */
+export async function fetchProductBySlug(slug: string): Promise<ProductDetail | null> {
+  try {
+    const res = await wixRequest<Raw>(`/stores/v3/products/slug/${encodeURIComponent(slug)}`, { method: "GET", query: { fields: DETAIL_FIELDS } });
+    return res?.product ? toDetail(res.product, imgSrc, mediaKey) : null;
+  } catch (e) {
+    if (notFound(e)) return null;
+    throw e;
+  }
+}
+
+/**
+ * The live category tree for navigation — never a seeded list. The filter must be non-empty;
+ * `visible` is not filterable (dropped client-side); the auto-created "all-products" system
+ * category is skipped. Non-fatal: [] on failure.  POST /categories/v1/categories/query
+ */
+export async function fetchCategories(): Promise<Category[]> {
+  try {
+    const res = await wixRequest<Raw>("/categories/v1/categories/query", {
+      body: { treeReference: STORES_TREE, query: { filter: { name: { $exists: true } }, cursorPaging: { limit: 100 } } },
+    });
+    return ((res?.categories ?? []) as Raw[]).filter((c) => c.visible !== false && c.slug !== "all-products").map(toCategory);
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * One category by URL slug (its id feeds searchCatalog). The response is WRAPPED: { category }.
+ * null when missing or hidden → a real 404.  GET /categories/v1/categories/slug/{slug}
+ */
+export async function fetchCategoryBySlug(slug: string): Promise<Category | null> {
+  try {
+    const res = await wixRequest<Raw>(`/categories/v1/categories/slug/${encodeURIComponent(slug)}`, {
+      method: "GET",
+      query: { "treeReference.appNamespace": "@wix/stores" },
+    });
+    const raw: Raw | undefined = res?.category;
+    return raw && raw.visible !== false ? toCategory(raw) : null;
+  } catch (e) {
+    if (notFound(e)) return null;
+    throw e;
+  }
+}

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

@@ -15,6 +15,10 @@ not a store product.
 node <SKILL_ROOT>/references/storefront/seed/seed-store.mjs plan.json
 ```
 
+Run this way, the result is the process itself: exit code `0` and the JSON on stdout (redirect it
+to a file if you want it later). `.seed-exit` and `seed-result.json` are written by
+`install/fast-path.mjs` when IT starts the seed — don't wait for them after a manual run.
+
 `plan.json` is plain data — write it from the brief:
 
 ```json
@@ -69,13 +73,29 @@ node <SKILL_ROOT>/references/storefront/seed/seed-store.mjs plan.json
   For a few seconds afterwards product reads can still report the old currency; that lag is
   expected and self-resolves, so don't re-verify it or retry.
 
-**Default to 3 products** unless the brief asks for a specific catalog — the seed shows the
-shape, not a full inventory; the owner adds the rest in the dashboard. **Make those 3 exercise
-the shipped UI**: give at least one product a color option and put one product on sale —
-truthfully to the business (a ceramics studio has glaze colors; a bakery doesn't).
+**Default to 3 products** when you draft the catalog yourself — the seed shows the shape, not a
+full inventory; the owner adds the rest in the dashboard. **Make those 3 exercise the shipped
+UI**: give at least one product a color option and put one product on sale — truthfully to the
+business (a ceramics studio has glaze colors; a bakery doesn't).
+
+## Supplied content
+
+The general rules are in `references/shared/SUPPLIED-CONTENT.md`. For a store, each product the user
+lists is one entry, whatever form the list arrives in. Its name, description and price become
+`name`, `description` and `price`. A "was", "regular" or "compare at" price becomes `compareAtPrice`
+when it is higher than the price. A stock count becomes `quantity`; "unlimited" or "made to order"
+becomes `"inStock": true`. A category, collection or type becomes an entry in `categories`. A set of
+choices the buyer picks from ("Small / Large", "S, M, L") becomes one `options` entry named after
+what it is (Size, Flavor), `type: "text"`; use `type: "color"` only when the source gives color codes.
+Their image becomes `imageUrl`. If a product has a separate price per size, seed it once at the
+lowest price and tell the user the per-variant prices are set in the dashboard. If a product has no
+price, ask; never invent one. Ribbons ("New", "Best Seller") and SKU codes are not seeded — say so.
 
 **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 — not even on a site created a minute ago. The Stores install adds its
+own sample products to a new catalog; they stay, and the owner removes them in the dashboard
+(the Manage products link is in your summary). If a cleanup genuinely seems needed, ask the user
+first. Categories are idempotent by name — 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

@@ -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,7 @@ export async function createCategories(ctx, names) {
   return out;
 }
 
+
 // 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)) {

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/ecommerce/ecom-shipping.md

@@ -29,7 +29,7 @@ Set up and tune how a store ships — what rates to charge, which regions are co
 
 > - [Set up shipping rates / rules](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-set-up-rates) — tags: `[intent:setup-rates]` · priority 0
 > - [Set up delivery regions / coverage](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-set-up-regions) — tags: `[intent:setup-regions]` · priority 0
-> - [Set up store pickup / local delivery](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/local-delivery) — tags: `[intent:setup-pickup]` · priority 0
+> - [Set up store pickup / local delivery](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-set-up-pickup-local-delivery) — tags: `[intent:setup-pickup]` · priority 0
 > - [Add free shipping over $X](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-add-free-shipping) — tags: `[intent:free-shipping]` · priority 0
 
 ### Optimize & fix

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" } } }'
 ```