@wix/agent-skills 1.35.0 → 1.36.0

package/skills/wix-app/references/editor-react-component/VECTOR-ART.md

@@ -0,0 +1,95 @@
+# Vector Art
+
+Use this reference when a component shows an icon or other SVG the site owner
+can replace. Fixed glyphs stay inline per
+CSS-GUIDELINES.md "SVG Icons".
+
+## The Prop
+
+Import `VectorArt` from `@wix/editor-react-types`. All fields are required; keep
+the whole object, never flatten it to a URL string.
+
+Declare it at the top level or as an array-item field, never in `elementProps`,
+which stays `className` only:
+
+```ts
+export type FeatureRowProps = {
+  icon?: VectorArt;
+  elementProps?: { featureRowIcon?: { className?: string } };
+};
+```
+
+## Render and Style
+
+The icon is a named part per `PARTS.md`. Inject `svgContent` unmodified (no
+`.replace()` or added attributes). Mark it `aria-hidden="true"` beside a visible label, or name the
+control with `a11y.ariaLabel` per `ACCESSIBILITY.md`.
+
+```tsx
+{icon && (
+  <span
+    {...elementProps?.featureRowIcon}
+    className={clsx('feature-row-icon', styles.icon, elementProps?.featureRowIcon?.className)}
+    aria-hidden="true"
+    dangerouslySetInnerHTML={{ __html: icon.svgContent }}
+  />
+)}
+```
+
+Declare the controls per CSS-GUIDELINES.md "SVG Icons", plus `--icon-rotation`
+via `rotate`. Add no border, background, or padding.
+
+```css
+.icon {
+  --icon-size: 24px;
+  --icon-color: #116dff;
+  --icon-rotation: 0deg;
+  display: block;
+  inline-size: var(--icon-size);
+  block-size: var(--icon-size);
+  fill: var(--icon-color);
+  rotate: var(--icon-rotation);
+}
+
+.icon svg {
+  display: block;
+  inline-size: 100%;
+  block-size: 100%;
+}
+```
+
+With several icons, give each part its own class and prefixed properties;
+shared names merge into one control. Only the property-free `svg` rule may be
+shared (`.startIcon svg, .endIcon svg`).
+
+## Defaults
+
+Populate all six fields in `defaultProps`; keep them there, with no second
+fallback in JSX. Never invent a `uri` or use a `data:` URI.
+
+```ts
+export const defaultProps = {
+  icon: {
+    uri: '417ddd_00f94d35a8f84b959241a5d4293ee772.svg',
+    viewBox: '0 0 200 200',
+    contentBox: '10 10 180 180',
+    colors: {},
+    contentType: 'shape',
+    svgContent:
+      '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" data-type="shape"><path d="M100 190c49.706 0 90-40.294 90-90s-40.294-90-90-90-90 40.294-90 90 40.294 90 90 90"/></svg>',
+  },
+} as const satisfies Omit<FeatureRowProps, 'id' | 'className'>;
+```
+
+For further slots substitute `uri` and the path `d` (same `viewBox` and `contentBox`):
+
+| `uri` | Shape | path `d` |
+| --- | --- | --- |
+| `417ddd_3d6ddf28b43e45499ea8557b8d963c79.svg` | Arch | `M100 10c49.704 0 90 37.654 90 84.102V190H10V94.102C10 47.654 50.294 10 100 10` |
+| `417ddd_c4e65c20d3844ffd97c9b2551ce7d269.svg` | Heptagon | `m100 10 72.174 35.651L190 125.76 140.054 190H59.946L10 125.759l17.826-80.108z` |
+
+## Checklist
+
+- [ ] A replaceable icon is a `VectorArt` prop, not an inline `<svg>` or URL string.
+- [ ] Each icon is its own named part injecting `svgContent` unmodified, with prefixed `--icon-*` properties.
+- [ ] `defaultProps` carries all six fields with a `uri` from the pool.

package/skills/wix-app/references/editor-react-component/VISUAL-QUALITY.md

@@ -0,0 +1,39 @@
+# Visual Quality
+
+Use this reference for a component's default look: hierarchy, spacing, and
+foreground/background contrast.
+
+**Visual intent.** When the request specifies how the component should look —
+mood, palette, layout style, or a reference — follow that direction. Default to a modern, refined look — intentional layout, pleasing proportions, polished and deliberate styling.
+
+## Default Visual Quality
+
+Create a clear hierarchy with at least two techniques that fit the component:
+a defined surface, border or soft shadow, type scale or weight, spacing, an
+accent, or visible interaction states. Use these neutral defaults unless the
+request or existing design provides better values:
+
+- 16px or larger body text, 14px or larger labels, and 600–700 weight for titles
+- 8–16px spacing inside controls and 16–32px spacing inside containers
+- 8–12px corner radii for cards and controls; `50%` for circular media
+- a subtle border or soft shadow when a card, panel, or control needs separation
+- touch targets at least 44 by 44px and visible keyboard focus states
+
+### Foreground and Background Ownership
+
+If the component is a self-contained block (card, panel, banner, accordion item), give the root a background. An inline control meant to blend in (link, ghost button, icon button) may leave it transparent.
+
+- On a transparent root, don't hardcode text or icon colors; inherit them from the parent.
+- Set the background and main text/icon color together on the same element. Any secondary text (captions, hints, icons) must still be readable against that same background.
+- If an interactive state changes the background, set the foreground color in that state too. Don't assume a color inherited from a parent or from a previous state will still look right on the new background.
+- In every default and interactive state, meet WCAG AA contrast: 4.5:1 for body text and 3:1 for large text and UI controls.
+
+A neutral owned surface may use a light background with dark primary and
+secondary foregrounds, plus one accessible accent. The exact colors are not a
+contract; the contrast relationship is.
+
+## Checklist
+
+- [ ] Visual containers have deliberate hierarchy rather than bare scaffolding.
+- [ ] Every explicit foreground has a known contrasting background; transparent
+      components inherit foregrounds from their host.

package/skills/wix-docs/references/CALLING.md

@@ -68,7 +68,7 @@ Append `.md` to read:
 - [`rest-api-authentication`](https://dev.wix.com/docs/api-reference/articles/authentication/rest-api-authentication) — headers, token kinds
 - [`retrieve-tokens`](https://dev.wix.com/docs/api-reference/business-management/headless/authentication/retrieve-tokens) — the `/oauth2/token` contract, all grant types
 - [`about-authentication`](https://dev.wix.com/docs/go-headless/authentication/about-authentication) — visitor vs member sessions
-- [`create-an-oauth-app-for-visitors-and-members`](https://dev.wix.com/docs/go-headless/getting-started/setup/authentication/create-an-oauth-app-for-visitors-and-members) — where the client id comes from
+- [`create-oauth-app`](https://dev.wix.com/docs/api-reference/business-management/headless/oauth-apps/create-oauth-app) — where the client id comes from
 - [`set-up-a-headless-client`](https://dev.wix.com/docs/go-headless/authentication/setup/set-up-a-headless-client) — wiring the client
 
 ## Dynamic Site Context — "what IS this site?"

package/skills/wix-headless-kit/guides/api-run.md

@@ -69,7 +69,7 @@ visitor tokens only, which cover what a visitor may see and nothing here.
 
 Unchanged from SKILL.md step 2 and its Verticals table: the brief names the business, the table
 names the solutions it needs. Read each solution's `{TEMPLATES}/{solution}/INSTRUCTIONS.md` for
-what it covers and `{TEMPLATES}/{solution}/seed/SEED.md` for what a seeded site holds.
+what it covers and `{TEMPLATES}/{solution}/seed/SEED.md` (`{solution}` is the template folder name, e.g. `storefront`, `bookings`) for what a seeded site holds.
 
 A brief that needs no solution (a game, a landing page, a tool) is a run of two steps: the site
 (step 2, with no `seedOptions`) and the frontend (step 5). No apps, no seed.

package/skills/wix-headless-kit/install/pins.json

@@ -3,6 +3,6 @@
   "@wix/create-new": "0.0.124",
   "typescript": "5.8.3",
   "templates": {
-    "ref": "v1.35.0"
+    "ref": "v1.36.0"
   }
 }

package/skills/wix-headless-templates/blog/seed/seed-blog.mjs

@@ -118,7 +118,7 @@ export async function installBlogApp(ctx) {
 
 // Every post create needs a REAL author memberId — a fabricated id fails with
 // "memberIds ... do not exist". A provisioned site has the owner as members[0].
-// docs: https://dev.wix.com/docs/api-reference/crm/members-contacts/members/members/list-members.md
+// docs: https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/members/list-members.md
 export async function getAuthorMemberId(ctx) {
   const r = await req(ctx, "/members/v1/members?fieldsets=PUBLIC&paging.limit=1", { method: "GET" });
   const id = r.members?.[0]?.id;

package/skills/wix-headless-templates/donations/app/wix/donations/campaigns.ts

@@ -22,7 +22,6 @@ const settingsApi = wixModule(ecommerceSettings);
 // The metrics list is EMPTY on a campaign nobody has donated to yet, and the campaign entity carries
 // formatted amounts but no currency code — so a fresh site would format nothing. The site's currency
 // comes from the eCommerce settings then (BUSINESS_INFO), read once per process; "" when refused.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/ecommerce-settings/get-ecommerce-settings.md
 let siteCurrencyPromise: Promise<string> | null = null;
 function siteCurrency(): Promise<string> {
   siteCurrencyPromise ??= settingsApi

package/skills/wix-headless-templates/donations/app/wix/donations/donate.ts

@@ -6,7 +6,7 @@
 // (shared with the REST twin); this file is the transport only. Copy as-is.
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/create-cart.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/orders/get-order.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/orders/get-order.md
 import { cartV2 as cartV2Module, orders as ordersModule } from "@wix/ecom";
 import { redirects as redirectsModule } from "@wix/redirects";
 import { wixModule } from "../sdk";

package/skills/wix-headless-templates/donations/project/src/wix/donations/campaigns.ts

@@ -22,7 +22,6 @@ const settingsApi = wixModule(ecommerceSettings);
 // The metrics list is EMPTY on a campaign nobody has donated to yet, and the campaign entity carries
 // formatted amounts but no currency code — so a fresh site would format nothing. The site's currency
 // comes from the eCommerce settings then (BUSINESS_INFO), read once per process; "" when refused.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/ecommerce-settings/get-ecommerce-settings.md
 let siteCurrencyPromise: Promise<string> | null = null;
 function siteCurrency(): Promise<string> {
   siteCurrencyPromise ??= settingsApi

package/skills/wix-headless-templates/donations/project/src/wix/donations/donate.ts

@@ -6,7 +6,7 @@
 // (shared with the REST twin); this file is the transport only. Copy as-is.
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/create-cart.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/orders/get-order.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/orders/get-order.md
 import { cartV2 as cartV2Module, orders as ordersModule } from "@wix/ecom";
 import { redirects as redirectsModule } from "@wix/redirects";
 import { wixModule } from "../sdk";

package/skills/wix-headless-templates/donations/rest/campaigns.ts

@@ -16,7 +16,6 @@ const BASE = "/donation-campaigns/v2/donation-campaigns";
 // A campaign nobody has donated to yet has no metrics entry, and the entity carries no currency code:
 // the site's currency then comes from the eCommerce settings, read once.
 // GET /_api/ecommerce-settings/v1/ecommerce-settings?fields=BUSINESS_INFO → { ecommerceSettings: { businessInfo: { currency } } }
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/ecommerce-settings/get-ecommerce-settings.md
 let siteCurrencyPromise: Promise<string> | null = null;
 function siteCurrency(): Promise<string> {
   siteCurrencyPromise ??= wixRequest<Raw>("/_api/ecommerce-settings/v1/ecommerce-settings", { method: "GET", query: { fields: ["BUSINESS_INFO"] } })

package/skills/wix-headless-templates/donations/rest/donate.ts

@@ -6,7 +6,7 @@
 // order yourself, never hand-build a checkout URL.
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/create-cart.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/orders/get-order.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/orders/get-order.md
 import { wixRequest } from "../../shared/rest/client.js";
 import {
   cartBody,

package/skills/wix-headless-templates/events/seed/seed-events.mjs

@@ -85,7 +85,7 @@ function buildRegistration(ev) {
 // Forms API AFTER the event exists (Create Event ignores form.controls; probed live 2026-09-28). The
 // control lands as a count input (options "0".."N") plus a names list capped at N — the shape the
 // site's form reader (events-core toRsvpForm) reads its max from — and takes effect at once.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/forms/add-control.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/form/add-control.md
 export async function addGuestControl(ctx, eventId, guests) {
   const n = Number(guests);
   if (!Number.isInteger(n) || n < 1) return false;

package/skills/wix-headless-templates/faq/INSTRUCTIONS.md

@@ -296,7 +296,7 @@ without telling the owner.
 
 ## Verification caveats
 
-The FAQ API's reference exists (`https://dev.wix.com/docs/rest/business-management/faq-app/…`) and the
+The FAQ API's reference exists (`https://dev.wix.com/docs/api-reference/business-management/faq-app/…`) and the
 shipped calls follow it: `POST /faq/v2/categories/query`, `POST /faq/v2/question-entries/query`, the
 `RICH_CONTENT` content format and the `SHARE_LINKS` field set. Not confirmed on a live site, and
 guarded in the code:

package/skills/wix-headless-templates/faq/app/wix/faq/faq.ts

@@ -3,8 +3,8 @@
 // rules and mappers live in ./faq-core (shared with the REST twin in templates/faq/rest/); this file
 // is the transport only. Copy as-is; extend by adding functions, not by editing these. The vertical
 // is read-only: authoring stays in the dashboard.
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/query-categories.md
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/query-question-entries.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/category-v2/query-categories.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/question-entry-v2/query-question-entries.md
 import { category as categoryModule, questionEntry as questionModule } from "@wix/faq";
 import { wixModule } from "../sdk";
 import { imgSrc } from "../media";

package/skills/wix-headless-templates/faq/project/src/wix/faq/faq.ts

@@ -3,8 +3,8 @@
 // rules and mappers live in ./faq-core (shared with the REST twin in templates/faq/rest/); this file
 // is the transport only. Copy as-is; extend by adding functions, not by editing these. The vertical
 // is read-only: authoring stays in the dashboard.
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/query-categories.md
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/query-question-entries.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/category-v2/query-categories.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/question-entry-v2/query-question-entries.md
 import { category as categoryModule, questionEntry as questionModule } from "@wix/faq";
 import { wixModule } from "../sdk";
 import { imgSrc } from "../media";

package/skills/wix-headless-templates/faq/rest/faq.ts

@@ -5,8 +5,8 @@
 // them is not documented — the reference shows an elevated example — so a 403 here means the site's
 // read needs a server-side path, not that the body is wrong (INSTRUCTIONS.md, verification caveats).
 // Porting: keep the paths, keep the bodies, port the core once.
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/query-categories.md
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/query-question-entries.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/category-v2/query-categories.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/question-entry-v2/query-question-entries.md
 import { wixRequest } from "../../shared/rest/client.js";
 import { imgSrc } from "../../shared/rest/media.js";
 import {

package/skills/wix-headless-templates/faq/seed/SEED.md

@@ -82,7 +82,7 @@ partial re-seed.
 
 ## Verification caveats
 
-The FAQ API's reference pages exist (`dev.wix.com/docs/rest/business-management/faq-app/…`) and
+The FAQ API's reference pages exist (`dev.wix.com/docs/api-reference/business-management/faq-app/…`) and
 every path, verb, and body here follows them; the following were not checked on a live site:
 
 - Whether the create endpoints answer 409 on a duplicate title/question or create a second copy. The

package/skills/wix-headless-templates/faq/seed/read-site.mjs

@@ -3,7 +3,7 @@
 import { runReader } from "../../shared/seed/read-site.mjs";
 
 const FAQ_APP_ID = "14c92d28-031e-7910-c9a8-a670011e062d";
-const D = "https://dev.wix.com/docs/rest/business-management/faq-app/faq";
+const D = "https://dev.wix.com/docs/api-reference/business-management/faq-app";
 
 await runReader({
   vertical: "faq",

package/skills/wix-headless-templates/faq/seed/seed-faq.mjs

@@ -25,7 +25,7 @@ import { readFileSync } from "node:fs";
 
 const API = "https://www.wixapis.com";
 const FAQ_APP_ID = "14c92d28-031e-7910-c9a8-a670011e062d";
-const D = "https://dev.wix.com/docs/rest/business-management/faq-app/faq";
+const D = "https://dev.wix.com/docs/api-reference/business-management/faq-app";
 /** The API's page cap (CursorPaging.limit max 100). */
 const PAGE_LIMIT = 100;
 /** sortOrder step — increments of 10 leave room to insert between items later (the reference's own tip). */
@@ -134,14 +134,14 @@ export async function installFaqApp(ctx) {
 }
 
 // Existing categories, straight from the query (the source of truth for what persisted).
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/query-categories.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/category-v2/query-categories.md
 export async function readCategories(ctx) {
   const r = await reqRetryOnce(ctx, "/faq/v2/categories/query", { body: { query: { cursorPaging: { limit: PAGE_LIMIT } } } });
   return (r.categories ?? []).map((c) => ({ id: rawId(c), title: c.title ?? "", sortOrder: typeof c.sortOrder === "number" ? c.sortOrder : null }));
 }
 
 // Every existing question (paged by cursor; PLAIN_TEXT keeps the read light — only the text is compared).
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/query-question-entries.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/question-entry-v2/query-question-entries.md
 export async function readQuestions(ctx) {
   const out = [];
   let cursor = null;
@@ -164,7 +164,7 @@ export async function readQuestions(ctx) {
 //  2. Idempotency — an already-present title (a partial-failure re-run, Wix's sample content) is kept.
 // New categories append after the existing ones: sortOrder = max(existing) + 10, +20, …
 // Body is NESTED: { category: { title, sortOrder } } → { category: { id, … } }.
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/create-category.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/category-v2/create-category.md
 export async function ensureCategories(ctx, titles) {
   let existing = await readCategories(ctx);
   const byTitle = () => new Map(existing.map((c) => [norm(c.title), c]));
@@ -196,7 +196,7 @@ export async function ensureCategories(ctx, titles) {
 
 // One question, one call (the SDK exports no bulk create). Body is NESTED: { questionEntry: { … } } →
 // { questionEntry: { id, slug, … } }. `question` and `categoryId` are required; the answer is a oneof.
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/create-question-entry.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/question-entry-v2/create-question-entry.md
 export async function createQuestion(ctx, { question, categoryId, sortOrder, labels, answer }, idx) {
   const body = {
     questionEntry: {

package/skills/wix-headless-templates/forms/app/wix/forms/forms.ts

@@ -13,8 +13,8 @@
 // implicit visitor access so a published site can render its own forms. Do NOT add a backend, a
 // connector token, or auth.elevate to make a form load.
 //
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/forms/get-form.md
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/forms/list-forms.md
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/get-form.md
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/list-forms.md
 // docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/about-form-fields.md
 import { wixFetch } from "../sdk";
 import { imgSrc } from "../media";

package/skills/wix-headless-templates/forms/app/wix/forms/submissions.ts

@@ -13,8 +13,8 @@
 // scope and 403s. The resolved create IS the confirmation — show a thank-you; the entry appears
 // in the owner's dashboard. A site that must LIST what visitors submitted needs `cms` instead.
 //
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/submissions/create-submission.md
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/submissions/get-media-upload-url.md
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/create-submission.md?apiView=SDK
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/get-media-upload-url.md?apiView=SDK
 // docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/about-submission-values.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
 import { submissions as submissionsModule } from "@wix/forms";

package/skills/wix-headless-templates/forms/project/src/wix/forms/forms.ts

@@ -13,8 +13,8 @@
 // implicit visitor access so a published site can render its own forms. Do NOT add a backend, a
 // connector token, or auth.elevate to make a form load.
 //
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/forms/get-form.md
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/forms/list-forms.md
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/get-form.md
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/list-forms.md
 // docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/about-form-fields.md
 import { wixFetch } from "../sdk";
 import { imgSrc } from "../media";

package/skills/wix-headless-templates/forms/project/src/wix/forms/submissions.ts

@@ -13,8 +13,8 @@
 // scope and 403s. The resolved create IS the confirmation — show a thank-you; the entry appears
 // in the owner's dashboard. A site that must LIST what visitors submitted needs `cms` instead.
 //
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/submissions/create-submission.md
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/submissions/get-media-upload-url.md
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/create-submission.md?apiView=SDK
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/get-media-upload-url.md?apiView=SDK
 // docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/about-submission-values.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
 import { submissions as submissionsModule } from "@wix/forms";

package/skills/wix-headless-templates/members/seed/read-site.mjs

@@ -3,7 +3,7 @@
 import { runReader } from "../../shared/seed/read-site.mjs";
 
 const MEMBERS_AREA_APP_ID = "14cc59bc-f0b7-15b8-e1c7-89ce41d0e0c9";
-const D = "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/members";
+const D = "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/members";
 
 await runReader({
   vertical: "members",

package/skills/wix-headless-templates/pricing-plans/app/wix/pricing-plans/plan-access.ts

@@ -12,7 +12,7 @@
 //   manual client (React SPA, lib) — the shared seam holds a VISITOR token; pass a call bound to the
 //             member's client instead, e.g. from templates/members' client.ts strategy:
 //             `createClient({ auth: membersAuth, modules: { orders } }).orders.memberListOrders`.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/member-list-orders.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/member-orders-service-list-orders.md
 import { orders as ordersModule } from "@wix/pricing-plans";
 import { wixModule } from "../sdk";
 import { hasPlanAccess, memberOrdersQuery, type MemberOrdersQuery } from "./plan-access-core";

package/skills/wix-headless-templates/pricing-plans/project/src/wix/pricing-plans/plan-access.ts

@@ -12,7 +12,7 @@
 //   manual client (React SPA, lib) — the shared seam holds a VISITOR token; pass a call bound to the
 //             member's client instead, e.g. from templates/members' client.ts strategy:
 //             `createClient({ auth: membersAuth, modules: { orders } }).orders.memberListOrders`.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/member-list-orders.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/member-orders-service-list-orders.md
 import { orders as ordersModule } from "@wix/pricing-plans";
 import { wixModule } from "../sdk";
 import { hasPlanAccess, memberOrdersQuery, type MemberOrdersQuery } from "./plan-access-core";

package/skills/wix-headless-templates/pricing-plans/rest/plan-access.ts

@@ -4,7 +4,7 @@
 // after the members vertical's rest/auth.ts login (`loggedInHint()` true) — and is refused for a
 // visitor, so callers check the session first (the store does) and never call for a visitor.
 // Porting: keep the path and the query string; the rule is one line in the core.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/member-list-orders.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/member-orders-service-list-orders.md
 import { wixRequest } from "../../shared/rest/client.js";
 import { hasPlanAccess, memberOrdersQuery, type MemberOrdersQuery } from "../app/wix/pricing-plans/plan-access-core.js";
 import type { Raw } from "../app/wix/pricing-plans/plans-core.js";

package/skills/wix-headless-templates/restaurants/app/wix/restaurants/menu.ts

@@ -9,7 +9,6 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/item-modifier-groups/list-modifier-groups.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/item-modifiers/list-modifiers.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/item-labels/list-labels.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/ecommerce-settings/get-ecommerce-settings.md
 import {
   menus as menusModule,
   sections as sectionsModule,

package/skills/wix-headless-templates/restaurants/project/src/wix/restaurants/menu.ts

@@ -9,7 +9,6 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/item-modifier-groups/list-modifier-groups.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/item-modifiers/list-modifiers.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/item-labels/list-labels.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/ecommerce-settings/get-ecommerce-settings.md
 import {
   menus as menusModule,
   sections as sectionsModule,

package/skills/wix-headless-templates/restaurants/rest/menu.ts

@@ -6,7 +6,6 @@
 // port the core once. Entities carry `id` here (the SDK spells it `_id`); the core accepts both.
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/menus/list-menus.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/items/list-items.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/ecommerce-settings/get-ecommerce-settings.md
 import { wixRequest } from "../../shared/rest/client.js";
 import { imgSrc } from "../../shared/rest/media.js";
 import {

package/skills/wix-headless-templates/shared/rest/client.ts

@@ -14,7 +14,7 @@
 //   server (a Python/PHP/Go port) — the SHOPPER'S SESSION, one token set per shopper. Never one
 //             process-wide token for everyone: that is one shared cart for all visitors.
 //             This is the only part of a port that isn't line-for-line.
-// docs: https://dev.wix.com/docs/go-headless/coding/authentication/visitors.md
+// docs: https://dev.wix.com/docs/go-headless/authentication/visitors/authenticate-visitors-rest.md
 import { WIX_CLIENT_ID } from "./config.js";
 
 export const WIX_API_BASE = "https://www.wixapis.com";

package/skills/wix-headless-templates/shared/seed/site.mjs

@@ -7,7 +7,8 @@ const API = "https://www.wixapis.com";
 // cannot be repriced afterwards. A new site starts in the currency of the account that created
 // it, not the business's. Reads can report the old currency for a few seconds after this returns;
 // that lag is expected and self-resolves.
-// docs: https://dev.wix.com/docs/rest/business-management/site-properties/properties/update-site-properties
+// No reference page documents this PATCH any more (Update Site Properties left the docs). The docs
+// cover the same field only under Update Business Region, a different endpoint and body.
 export async function setSiteCurrency(ctx, currency) {
   if (!/^[A-Z]{3}$/.test(currency)) throw new Error(`currency must be a 3-letter ISO code, got "${currency}"`);
   const res = await fetch(`${API}/site-properties/v4/properties`, {

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

@@ -107,4 +107,3 @@ Returns `lowOffer` / `mediumOffer` / `highOffer`, each with `incentiveId`, `awar
 - [Get Keyword Theme Suggestions](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-keyword-theme-suggestions)
 - [Get Geo Options](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-geo-options)
 - [Get Budget Suggestions](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-budget-suggestions)
-- [Get Incentives](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-incentives)

package/skills/wix-manage/references/google-ads/install-and-create-account.md

@@ -152,4 +152,3 @@ Returns `{}`. Errors with `ACCOUNT_NOT_FOUND` if no account exists.
 - [Account Service](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-account-v1/introduction)
 - [Create Account](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-account-v1/create-account)
 - [Get Account For Current Site](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-account-v1/get-account-for-current-site)
-- [Get Incentives](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-incentives)

package/skills/wix-manage/references/rich-content/ricos-converter-service.md

@@ -13,7 +13,7 @@ Ricos is Wix's rich content format used across various Wix applications (Blog, S
 - **Convert to Ricos**: Transform HTML, Markdown, or plain text into a Ricos document
 - **Convert from Ricos**: Transform a Ricos document back to HTML, Markdown, or plain text
 
-Learn more about [Rich Content](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/platform/about-rich-content) and [Ricos document structure](https://dev.wix.com/docs/ricos/getting-started/introduction).
+Learn more about [Rich Content](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/platform/about-rich-content) and [Ricos document structure](https://dev.wix.com/docs/api-reference/assets/rich-content/ricos-documents/document-object).
 
 ## Required API Endpoints
 

package/skills/wix-manage/references/sites/upload-static-site.md

@@ -476,12 +476,14 @@ If a call fails after publishing, inspect the current snapshot before retrying:
 the write may have succeeded and only its subsequent verification failed.
 Avoid repeating a mutation merely because the last call returned an error.
 
-Give the live URL, what changed, what was verified, and any missing assets.
-On first authenticated publish (or after claim), also give
-`https://manage.wix.com/dashboard/{metaSiteId}` and
-[domain connection](../domains/domain-search-purchase-and-connect.md) options
-for a Wix-purchased or existing domain. For an unclaimed anonymous site, give
-the live URL and private save link instead, not a dashboard link.
+Give the user two links, each on its own line and named for what it is: the
+live site, `{siteUrl}`, and the site's dashboard,
+`https://manage.wix.com/dashboard/{metaSiteId}`. Every publish and every edit
+closes with both. Then what changed, what was verified, any missing assets, and
+[domain connection](../domains/domain-search-purchase-and-connect.md) options:
+a domain bought through Wix, or one the user already owns. For an unclaimed
+anonymous site, give the live URL and private save link instead, not a
+dashboard link.
 
 ## Connect a backend
 

package/skills/wix-replatform/resources/rp-mapper/wix-business-solutions-taxonomy.md

@@ -96,9 +96,9 @@ Primary entities:
 
 | Entity | What it does | Docs |
 | --- | --- | --- |
-| `cart` | First phase of the purchase flow; holds line items, buyer references, discounts, and pricing context before checkout | [About the eCommerce Cart API](https://dev.wix.com/docs/rest/business-solutions/e-commerce/purchase-flow/cart/cart/introduction) |
-| `current-cart` | Visitor/member scoped cart used in live purchase flows | [About the eCommerce Current Cart API](https://dev.wix.com/docs/sdk/backend-modules/ecom/current-cart/introduction) |
-| `checkout` | Second phase of purchase flow; holds calculated prices, tax, billing, shipping, and discount state before order creation | [About the eCommerce Checkout API](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction) |
+| `cart` | First phase of the purchase flow; holds line items, buyer references, discounts, and pricing context before checkout | [About the Cart API (Cart V2, replaces the eCommerce Cart API)](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/introduction) |
+| `current-cart` | Visitor/member scoped cart used in live purchase flows | [About the Cart API (Cart V2, its Current Cart service)](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/introduction?apiView=SDK) |
+| `checkout` | Second phase of purchase flow; holds calculated prices, tax, billing, shipping, and discount state before order creation | [About the Cart API (Cart V2, replaces the eCommerce Checkout API)](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/introduction?apiView=SDK) |
 | `order` | Final commerce record for completed or externally recorded purchases | [About the Orders API](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/orders/introduction) |
 | `order-billing` | Payment capture, void, and refund operations for eCommerce orders | [About the Order Billing API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/order-billing/introduction) |
 
@@ -179,7 +179,7 @@ Primary entities:
 | `ticket-definition` | Ticket type template such as General Admission or VIP | [Event Management introduction](https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/introduction) |
 | `ticket` | Purchased ticket with guest and check-in state | [About the Tickets API](https://dev.wix.com/docs/api-reference/business-solutions/events/registration/ticketing/tickets/introduction?apiView=SDK) |
 | `event-order` | Ticket purchase and registration order lifecycle | [About the Orders API](https://dev.wix.com/docs/sdk/backend-modules/events/orders/on-order-initiated) |
-| `rsvp` | RSVP response and attendance state for non-ticketed events | [About RSVP API](https://dev.wix.com/docs/sdk/backend-modules/events/rsvp/introduction) |
+| `rsvp` | RSVP response and attendance state for non-ticketed events | [About the RSVP API](https://dev.wix.com/docs/api-reference/business-solutions/events/registration/rsvp-v2/introduction?apiView=SDK) |
 | `event-guest` | Unified guest record across ticketed and RSVP events | [About the Event Guests API](https://dev.wix.com/docs/api-reference/business-solutions/events/registration/event-guests/introduction?apiView=SDK) |
 | `events-registration` | Registration layer connecting RSVP, ticketing, and guests | [About Events Registration](https://dev.wix.com/docs/api-reference/business-solutions/events/registration/introduction) |
 
@@ -212,7 +212,7 @@ Primary entities:
 | `reservation` | Reservation lifecycle record for a party at a restaurant | [About the Reservations API](https://dev.wix.com/docs/api-reference/business-solutions/restaurants/wix-restaurants-new/reservations/reservations/introduction) |
 | `restaurant-time-slot` | Availability window for reservation booking | [Reservations API introduction](https://dev.wix.com/docs/rest/business-solutions/restaurants/wix-restaurants-new/reservations/introduction) |
 | `experience` | Special dining experience such as chef's table or tasting menu | [Experiences API](https://dev.wix.com/docs/api-reference/business-solutions/restaurants/wix-restaurants-new/reservations/experiences/introduction) |
-| `restaurant-order-legacy` | Legacy restaurant order model from the original Restaurants Orders app | [About Wix Restaurants Orders](https://dev.wix.com/docs/rest/business-solutions/restaurants/wix-restaurants/orders/introduction) |
+| `restaurant-order-legacy` | Legacy restaurant order model from the original Restaurants Orders app | [Restaurants Online Orders (the legacy Orders docs are removed)](https://dev.wix.com/docs/api-reference/business-solutions/restaurants/online-orders) |
 
 Mapper notes:
 - Restaurants spans multiple subdomains: menus, reservations, and in some cases restaurant ordering.