@wix/agent-skills 1.6.0 → 1.7.0

package/skills/wix-headless/scripts/seed-utilities.sh

@@ -1,21 +1,30 @@
 #!/usr/bin/env bash
-# Copy the skill's shared utilities into the project's src/utils/ and strip the
-# Astro starter cruft that ships with the blank template.
+# Frontend-track project prep: copy the skill's shared utilities into the
+# project's src/utils/ and strip the Astro starter cruft that ships with the
+# blank template. This is local-project (frontend) work, not backend seeding —
+# the orchestrator only runs it in scaffold mode (integrate mode has no
+# skill-written frontend to prep, so it is never invoked there).
 #
 # Usage (both modes work):
-#   bash <SKILL_ROOT>/scripts/seed-utilities.sh                # installed tgz
-#   bash <(curl -s https://dev.wix.com/skills/wix-headless/scripts/seed-utilities.sh)
+#   bash <SKILL_ROOT>/scripts/seed-utilities.sh --template astro
+#   bash <(curl -s https://dev.wix.com/skills/wix-headless/scripts/seed-utilities.sh) --template astro
 #
-# Run from the project directory (CWD = <project>/). The script auto-detects
+# --template (optional, default astro): astro
+#   Astro is the only frontend the skill scaffolds and preps, so the value is
+#   always "astro". Custom (non-astro) frontends route to the not-available stub
+#   (references/custom/INSTRUCTIONS.md) and never reach this script.
+#
+# Run from the project directory (CWD = <scaffold>/). The script auto-detects
 # whether shared-utilities is available on disk (tgz install) and falls back
 # to fetching from the well-known URL when streamed via process substitution
 # (BASH_SOURCE is /dev/fd/N, so the on-disk lookup naturally falls through).
 #
 # Behavior:
-#   - Copies the three shared utility files into src/utils/ — never overwrites
-#     an existing file (users can drop in their own version to override).
-#   - Removes Astro starter cruft (Welcome.astro + marketing SVGs) that ships
-#     with the blank template but is never imported by the build skill.
+#   - Copies the three shared utility files into src/utils/ for both templates —
+#     never overwrites an existing file (users can drop in their own version).
+#   - On --template=astro, removes Astro starter cruft (Welcome.astro + marketing
+#     SVGs) that ships with the blank template but is never imported by the build
+#     skill.
 #
 # Shared utilities copied:
 #   - wix-image.ts  — media URL resolver (used by stores, blog, cms)
@@ -27,6 +36,33 @@ set -euo pipefail
 SKILL_URL="https://dev.wix.com/skills/wix-headless"
 UTILS=(analytics.ts ricos.ts wix-image.ts)
 
+TEMPLATE="astro"
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --template)
+      TEMPLATE="$2"
+      shift 2
+      ;;
+    --template=*)
+      TEMPLATE="${1#--template=}"
+      shift
+      ;;
+    *)
+      echo "seed-utilities.sh: unexpected arg: $1" >&2
+      exit 2
+      ;;
+  esac
+done
+
+case "$TEMPLATE" in
+  astro) ;;
+  *)
+    echo "seed-utilities.sh: --template must be 'astro' (the only supported frontend); got $TEMPLATE" >&2
+    echo "(Custom non-astro frontends route to the stub and never reach this script.)" >&2
+    exit 2
+    ;;
+esac
+
 # Mode detection: prefer on-disk skill root if the sibling dir exists, else
 # fetch over HTTP. Covers both tgz install and `bash <(curl ...)` streaming.
 SHARED_UTILS_DIR=""
@@ -50,6 +86,8 @@ for f in "${UTILS[@]}"; do
   fi
 done
 
-# Astro starter cruft cleanup.
-rm -f src/components/Welcome.astro
-rm -f src/assets/astro.svg src/assets/wix.svg src/assets/background.svg
+# Astro starter cruft cleanup — astro template only.
+if [[ "$TEMPLATE" == "astro" ]]; then
+  rm -f src/components/Welcome.astro
+  rm -f src/assets/astro.svg src/assets/wix.svg src/assets/background.svg
+fi

package/skills/wix-manage/SKILL.md

@@ -1,11 +1,13 @@
 ---
 name: wix-manage
-description: "Wix business solution management recipes — REST API operations for configuring and managing Wix business solutions. Routes to: stores, bookings, get-paid, CMS, contacts, events, forms, media, app-installation, pricing-plans, restaurants, rich-content, sites, blog, calendar, domains, site-properties, ecommerce."
+description: "Wix business solution management recipes — REST API operations for configuring and managing Wix business solutions. Routes to: stores, bookings, get-paid, CMS, contacts, forms, media, app-installation, pricing-plans, restaurants, rich-content, sites, blog, calendar, domains, site-properties, ecommerce."
 compatibility: Requires Wix REST API access (API key or OAuth).
 ---
 
 # Management Recipes Index
 
+> **Standard call shape for every curl example across these recipes.** The `<AUTH>` placeholder in example curls is shorthand for the `Authorization` header only; every actual call ALSO needs `wix-site-id: <SITE_ID>` and `Content-Type: application/json`. **POST/PATCH against `wix-data/*`, `form-schema-service/*`, `stores/v3/*`, `blog/v3/*`, and other site-scoped REST families return 403 without `wix-site-id`** — observed seeder regression cost ~100 s rediscovering this on a 2026-05-24 run. Mint the token via `npx @wix/cli@latest token --site "$SITE_ID"`.
+
 ## What Are Management Recipes?
 
 **Management recipes are for REST API operations** that configure, set up, and manage Wix business entities on your site. These recipes use REST API calls and are designed for:
@@ -155,6 +157,7 @@ These recipes do NOT cover frontend development or SDK usage for displaying data
 
 #### Config & API References
 - [API: Recommendation Tracking](references/ecommerce/api-recommendation-tracking.md)
+- [API: Shipping Delivery](references/ecommerce/api-shipping.md)
 - [Setup: Discount Rules](references/ecommerce/setup-discount-rules.md)
 - [Setup: Coupons](references/ecommerce/setup-coupons.md)
 - [Setup: Shipping Regions](references/ecommerce/setup-shipping-regions.md)
@@ -171,13 +174,6 @@ These recipes do NOT cover frontend development or SDK usage for displaying data
 
 ---
 
-## Events
-
-### [List Events](references/events/list-events.md)
-**Technical:** Queries events from Wix Events using Events API. Covers field sets (DETAILS, URLS, REGISTRATION), filtering by status/date, and pagination.
-
----
-
 ## Forms
 
 ### [Create Form](references/forms/create-form.md)

package/skills/wix-manage/references/blog/how-to-create-blog-posts.md

@@ -5,6 +5,8 @@ description: Creates and publishes blog posts using Blog Posts API. Covers Ricos
 
 **Article: Create and Publish Blog Posts with Rich Content and Images**
 
+> **Standard call shape (every curl below).** The `<AUTH>` placeholder is shorthand for `Authorization: Bearer <TOKEN>` only. Every actual call ALSO needs `wix-site-id: <SITE_ID>` and (for body-bearing requests) `Content-Type: application/json`. **POST against `blog/v3/*` returns 403 without `wix-site-id`** — recipe examples below show `<AUTH>` only for brevity, but the header is required on every call you make. Token: `npx @wix/cli@latest token --site "$SITE_ID"`.
+
 ---
 
 ## Description

package/skills/wix-manage/references/cms/cms-data-items-crud.md

@@ -4,6 +4,8 @@ description: "Add, query, update, and delete items in CMS collections. Use this
 ---
 # CMS Data Items CRUD
 
+> **Standard call shape (every curl below).** The `<AUTH>` placeholder is shorthand for `Authorization: Bearer <TOKEN>` only. Every actual call ALSO needs `wix-site-id: <SITE_ID>` and (for body-bearing requests) `Content-Type: application/json`. **POST/PATCH against `wix-data/*` returns 403 without `wix-site-id`** — recipe examples below show `<AUTH>` only for brevity, but the header is required on every call you make. Token: `npx @wix/cli@latest token --site "$SITE_ID"`.
+
 This recipe covers basic Create, Read, Update, Delete (CRUD) operations for Wix CMS data items.
 
 ## Prerequisites
@@ -365,6 +367,8 @@ curl -X DELETE \
 | `IMAGE` | Image reference (HTTP url or wix:image://v1/{mediaId}/{friendlyName}) | `"wix:image://v1/3f72369f2219e2ee853e9e3df0217ce1.jpg/Colorful%20Business%20Cards.jpg"` |
 | `VIDEO` | Video reference (HTTP url or wix:video://v1/{mediaId}/{friendlyName}) | `"wix:video://v1/11062b_484182533ede4b9a81329daf20238867/Sketching%20Design%20Concepts#posterUri=11062b_484182533ede4b9a81329daf20238867f000.jpg&posterWidth=1920&posterHeight=1080"` |
 | `DOCUMENT` | Document reference  (HTTP url or wix:document://v1/{mediaId}) | `"wix:document://v1/..."` |
+| `MEDIA_IMAGE` | Wix Media Image | `{ "url": "http://...", "height": 640, "width": 480, "alt": "Picture" }` |
+| `MEDIA_VECTOR_ART` | Wix Media Vector Art | `{ "uri": "wix:vector://v1/...", "viewBox": "0 0 100 100", "contentType": "shape", "svgContent": "<svg>...</svg>" }` |
 | `URL` | Web URL | `"https://example.com"` |
 | `RICH_TEXT` | HTML content | `"<p>Rich text</p>"` |
 | `EMAIL` | Email | `"example@wix.com"` |

package/skills/wix-manage/references/cms/cms-references-and-relationships.md

@@ -4,6 +4,8 @@ description: "Add, replace, or remove items from MULTI_REFERENCE fields. Use ins
 ---
 # CMS References & Relationships
 
+> **Standard call shape (every curl below).** The `<AUTH>` placeholder is shorthand for `Authorization: Bearer <TOKEN>` only. Every actual call ALSO needs `wix-site-id: <SITE_ID>` and (for body-bearing requests) `Content-Type: application/json`. **POST/PATCH against `wix-data/*` returns 403 without `wix-site-id`** — recipe examples below show `<AUTH>` only for brevity, but the header is required on every call you make. Token: `npx @wix/cli@latest token --site "$SITE_ID"`.
+
 This recipe covers linking CMS collections together using reference fields.
 
 ## Prerequisites

package/skills/wix-manage/references/cms/cms-schema-management.md

@@ -4,6 +4,8 @@ description: Create and modify CMS collection structures. Covers listing collect
 ---
 # CMS Schema Management
 
+> **Standard call shape (every curl below).** The `<AUTH>` placeholder is shorthand for `Authorization: Bearer <TOKEN>` only. Every actual call ALSO needs `wix-site-id: <SITE_ID>` and (for body-bearing requests) `Content-Type: application/json`. **POST/PATCH against `wix-data/*` returns 403 without `wix-site-id`** — recipe examples below show `<AUTH>` only for brevity, but the header is required on every call you make. Token: `npx @wix/cli@latest token --site "$SITE_ID"`.
+
 This recipe covers managing the structure (schema) of Wix CMS collections using the REST API.
 
 ## Prerequisites
@@ -120,6 +122,8 @@ curl -X GET \
 | `DATE` | Date only | `"2024-01-15"` |
 | `DATETIME` | Date and time | `{ "$date": "2024-01-15T10:00:00.000Z" }` |
 | `IMAGE` | Image reference | `"wix:image://v1/..."` |
+| `MEDIA_IMAGE` | Wix Media Image | `{ "url": "http://...", "height": 640, "width": 480, "alt": "Picture" }` |
+| `MEDIA_VECTOR_ART` | Wix Media Vector Art | `{ "uri": "wix:vector://v1/...", "viewBox": "0 0 100 100", "contentType": "shape", "svgContent": "<svg>...</svg>" }` |
 | `URL` | Web URL | `"https://example.com"` |
 | `RICH_TEXT` | HTML content | `"<p>Rich text</p>"` |
 | `ARRAY_STRING` | Array of strings | `["tag1", "tag2"]` |

package/skills/wix-manage/references/ecommerce/api-shipping.md

@@ -0,0 +1,443 @@
+---
+name: "API: Shipping Delivery"
+description: REST API reference for Shipping Options and Delivery Profiles. Covers CRUD operations, region/carrier management, and query patterns for both services. Internal reference — these APIs are not yet published in public docs.
+layer: config
+---
+# API: Shipping Delivery
+
+Two services govern the shipping configuration of a Wix eCommerce store:
+
+- **Delivery Profiles** — define geographic regions and which carriers serve each region. Each site has a default profile. Regions contain destinations (countries/subdivisions) and carriers.
+- **Shipping Options** — define the rate entries customers see at checkout (flat, tiered, free). Each option is scoped to one or more delivery regions.
+
+**Base URL**: `https://www.wixapis.com/ecom`
+
+**How to call these APIs**: Use `CallWixSiteAPI`.
+
+---
+
+## Shipping Options
+
+### Query Shipping Options
+
+Retrieves all shipping options for the site. Up to 1,000 per request (cursor paging).
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/shipping-options/query`
+
+**Request**:
+```json
+{
+  "query": {
+    "cursorPaging": { "limit": 100 }
+  }
+}
+```
+
+**Filterable fields**: `id`, `delivery_region_id`, `delivery_region_ids`, `estimated_delivery_time`, `created_date`, `updated_date`
+
+**Response**:
+```json
+{
+  "shippingOptions": [
+    {
+      "id": "abc123",
+      "revision": "1",
+      "deliveryRegionId": "region-guid",
+      "deliveryRegionIds": ["region-guid"],
+      "title": "Standard Shipping",
+      "category": "STANDARD",
+      "estimatedDeliveryTime": "3-5 business days",
+      "rates": [
+        {
+          "id": "rate-guid",
+          "title": "Standard Shipping",
+          "amount": "5.99",
+          "multiplyByQuantity": false,
+          "active": true,
+          "conditions": []
+        }
+      ]
+    }
+  ],
+  "pagingMetadata": { "count": 1, "hasNext": false }
+}
+```
+
+---
+
+### Create Shipping Option
+
+Creates a new shipping option and associates it with one or more delivery regions.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/shipping-options`
+
+**Required fields**: `shippingOption.deliveryRegionId` (or `deliveryRegionIds`), `shippingOption.title`, `shippingOption.rates[]`
+
+**Request**:
+```json
+{
+  "shippingOption": {
+    "deliveryRegionId": "region-guid",
+    "title": "Free Shipping Over $75",
+    "category": "FREE",
+    "estimatedDeliveryTime": "5-7 business days",
+    "rates": [
+      {
+        "title": "Free Shipping",
+        "amount": "0",
+        "multiplyByQuantity": false,
+        "active": true,
+        "conditions": [
+          {
+            "type": "BY_TOTAL_PRICE",
+            "operator": "GTE",
+            "value": "75"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+**Response**: `{ "shippingOption": { ... } }` — the created option with `id` and `revision`.
+
+**Error**: `INVALID_QUANTITY_VALUE` (400) — condition value cannot be fractional.
+
+---
+
+### Get Shipping Option
+
+Retrieves a single shipping option by ID.
+
+**Endpoint**: `GET https://www.wixapis.com/ecom/v1/shipping-options/{shippingOptionId}`
+
+**Response**: `{ "shippingOption": { ... } }`
+
+---
+
+### Update Shipping Option
+
+Updates a shipping option. Requires `id` and the current `revision`. Each update increments `revision`.
+
+**Endpoint**: `PATCH https://www.wixapis.com/ecom/v1/shipping-options/{shippingOption.id}`
+
+**Required fields**: `shippingOption.id`, `shippingOption.revision`
+
+**Request**:
+```json
+{
+  "shippingOption": {
+    "id": "abc123",
+    "revision": "1",
+    "rates": [
+      {
+        "id": "rate-guid",
+        "title": "Free Shipping",
+        "amount": "0",
+        "multiplyByQuantity": false,
+        "active": true,
+        "conditions": [
+          {
+            "type": "BY_TOTAL_PRICE",
+            "operator": "GTE",
+            "value": "85"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+**Response**: `{ "shippingOption": { ... } }` with updated `revision`.
+
+---
+
+### Delete Shipping Option
+
+Permanently deletes a shipping option.
+
+**Endpoint**: `DELETE https://www.wixapis.com/ecom/v1/shipping-options/{shippingOptionId}`
+
+---
+
+### Add Delivery Region (to Shipping Option)
+
+Associates an additional delivery region with an existing shipping option.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/shipping-options/{shippingOptionId}/add-delivery-region`
+
+**Required fields**: `deliveryRegionId`, `revision`
+
+**Request**:
+```json
+{
+  "deliveryRegionId": "region-guid",
+  "revision": "2"
+}
+```
+
+---
+
+### Remove Delivery Region (from Shipping Option)
+
+Removes a delivery region association from a shipping option.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/shipping-options/{shippingOptionId}/remove-delivery-region`
+
+**Required fields**: `deliveryRegionId`, `revision`
+
+---
+
+## Rate Configuration
+
+Rate types are determined by the `conditions` array, not an explicit field:
+
+| Rate Type | `amount` | `conditions` |
+|-----------|---------|-------------|
+| Flat rate | any | empty `[]` |
+| Free shipping | `"0"` | optional `BY_TOTAL_PRICE GTE <threshold>` |
+| Price-based tiers | any | one or more `BY_TOTAL_PRICE` conditions |
+| Weight-based tiers | any | `BY_TOTAL_WEIGHT` conditions |
+| Quantity-based | any | `BY_TOTAL_QUANTITY` conditions |
+
+**Condition operators**: `EQ`, `GT`, `GTE`, `LT`, `LTE`
+
+Multiple conditions in one rate combine with AND logic.
+
+**`multiplyByQuantity: true`** charges `amount × cart quantity`. Flag this configuration — it penalizes large orders and should be replaced with flat or tiered pricing.
+
+---
+
+## Delivery Profiles
+
+### Query Delivery Profiles
+
+Retrieves all delivery profiles for the site. Typically one default profile exists.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/query`
+
+**Request**: `{}`
+
+**Response**:
+```json
+{
+  "deliveryProfiles": [
+    {
+      "id": "profile-guid",
+      "revision": "3",
+      "name": "General profile",
+      "default": true,
+      "deliveryRegions": [
+        {
+          "id": "region-guid",
+          "name": "United States",
+          "active": true,
+          "destinations": [
+            { "countryCode": "US", "subdivisions": [] }
+          ],
+          "deliveryCarriers": [
+            {
+              "appId": "45c44b27-ca7b-4891-8c0d-1747d588b835",
+              "backupRate": {
+                "title": "Standard Shipping",
+                "amount": "5.99",
+                "active": true
+              },
+              "additionalCharges": []
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
+```
+
+---
+
+### Get Delivery Profile
+
+Retrieves a single delivery profile by ID.
+
+**Endpoint**: `GET https://www.wixapis.com/ecom/v1/delivery-profiles/{deliveryProfileId}`
+
+**Response**: `{ "deliveryProfile": { ... } }`
+
+---
+
+### Get Delivery Profile by Region
+
+Retrieves the profile that contains a given delivery region.
+
+**Endpoint**: `GET https://www.wixapis.com/ecom/v1/delivery-profiles/delivery-regions/{deliveryRegionId}`
+
+---
+
+### Create Delivery Profile
+
+Creates a new delivery profile (rarely needed — most sites use the default profile).
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles`
+
+---
+
+### Update Delivery Profile
+
+Updates profile-level fields (name, etc.). Requires current `revision`.
+
+**Endpoint**: `PATCH https://www.wixapis.com/ecom/v1/delivery-profiles/{deliveryProfile.id}`
+
+---
+
+### Add Delivery Region
+
+Adds a geographic region to a delivery profile. Returns the updated profile with the new region's `id`.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/{deliveryProfileId}/delivery-region`
+
+**Required fields**: `deliveryRegion.name`, `deliveryRegion.destinations[]`, `revision`
+
+**Request**:
+```json
+{
+  "deliveryRegion": {
+    "name": "United States",
+    "active": true,
+    "destinations": [
+      { "countryCode": "US" }
+    ]
+  },
+  "revision": "3"
+}
+```
+
+**Response**: `{ "deliveryProfile": { ... } }` — full updated profile with new region `id`.
+
+**Error**: `DESTINATIONS_COLLISION` — country already assigned to another region in this profile. Use the existing region instead.
+
+---
+
+### Update Delivery Region
+
+Updates name, active status, or destinations of an existing region.
+
+**Endpoint**: `PATCH https://www.wixapis.com/ecom/v1/delivery-profiles/{deliveryProfileId}/delivery-region/{deliveryRegion.id}`
+
+---
+
+### Remove Delivery Region
+
+Removes a delivery region from a profile.
+
+**Endpoint**: `DELETE https://www.wixapis.com/ecom/v1/delivery-profiles/{deliveryProfileId}/delivery-region/{deliveryRegionId}`
+
+---
+
+### List Installed Delivery Carriers
+
+Returns all carriers installed on the site (both built-in and third-party apps). Use this to find the `id` of a specific carrier (e.g., Pickup, Basic Shipping) before calling Add Delivery Carrier.
+
+**Endpoint**: `GET https://www.wixapis.com/ecom/v1/delivery-profiles/installed-carriers`
+
+**Response**:
+```json
+{
+  "installedDeliveryCarriers": [
+    {
+      "id": "50d8c12f-715e-41ad-be25-d0f61375dbee",
+      "displayName": "Pickup",
+      "fallbackDefinitionMandatory": false,
+      "toggleGetCarrierSettingsEnabled": true
+    },
+    {
+      "id": "45c44b27-ca7b-4891-8c0d-1747d588b835",
+      "displayName": "Basic Shipping",
+      "description": "Manage shipping rates and options for this region",
+      "fallbackDefinitionMandatory": false,
+      "toggleGetCarrierSettingsEnabled": true
+    }
+  ]
+}
+```
+
+---
+
+### List Delivery Carriers (in a Profile)
+
+Lists the carriers configured within a specific delivery profile.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/{deliveryProfileId}/delivery-carriers`
+
+---
+
+### Add Delivery Carrier
+
+Adds a carrier to a delivery region within a profile. The carrier appears as a shipping option to customers in that region.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/add-delivery-carrier`
+
+**Request**:
+```json
+{
+  "deliveryRegionId": "region-guid",
+  "deliveryCarrier": {
+    "appId": "50d8c12f-715e-41ad-be25-d0f61375dbee",
+    "backupRate": {
+      "title": "Pickup at 123 Main St",
+      "amount": "0",
+      "active": true
+    }
+  }
+}
+```
+
+**Response**: `{ "deliveryProfile": { ... } }` — full updated profile.
+
+**Errors**:
+| Error | Cause |
+|-------|-------|
+| `CARRIER_ALREADY_EXISTS_IN_REGION` | Carrier already in this region |
+| `DELIVERY_CARRIER_MISSING_BACKUP_RATE` | `backupRate` or `backupRate.amount` missing |
+
+---
+
+### Remove Delivery Carrier
+
+Removes a carrier from a delivery region.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/remove-delivery-carrier`
+
+**Request**:
+```json
+{
+  "deliveryRegionId": "region-guid",
+  "appId": "carrier-app-id"
+}
+```
+
+---
+
+### Update Delivery Carrier
+
+Updates `backupRate` or `additionalCharges` for a carrier in a region.
+
+**Endpoint**: `PATCH https://www.wixapis.com/ecom/v1/delivery-profiles/update-delivery-carrier`
+
+---
+
+### Set Delivery Carrier Active Status
+
+Activates or deactivates a carrier in a delivery region.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/delivery-carriers/set-active-status`
+
+---
+
+## Known Carrier IDs
+
+| Carrier | App ID |
+|---------|--------|
+| Basic Shipping | `45c44b27-ca7b-4891-8c0d-1747d588b835` |
+| Pickup | `50d8c12f-715e-41ad-be25-d0f61375dbee` |

package/skills/wix-manage/references/ecommerce/flow-add-free-shipping.md

@@ -27,10 +27,10 @@ Adds a free shipping option with an optimal threshold calibrated against the sit
 
 ## Required APIs
 
-- [Query Shipping Options](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/query-shipping-options)
-- [Create Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/create-shipping-option)
-- [Update Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/update-shipping-option)
-- [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/query-delivery-profiles)
+- [Query Shipping Options](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-shipping-options)
+- [Create Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#create-shipping-option)
+- [Update Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#update-shipping-option)
+- [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-delivery-profiles)
 
 ---
 
@@ -263,5 +263,4 @@ Report to the merchant:
 
 ## References
 
-- [Delivery Profiles API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/introduction)
-- [Shipping Options API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/introduction)
+- [API: Shipping Delivery](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping)

package/skills/wix-manage/references/ecommerce/flow-fix-coverage-gaps.md

@@ -26,9 +26,9 @@ Detects delivery regions where customers cannot see any shipping options at chec
 
 ## Required APIs
 
-- [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/query-delivery-profiles)
-- [Query Shipping Options](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/query-shipping-options)
-- [Create Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/create-shipping-option)
+- [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-delivery-profiles)
+- [Query Shipping Options](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-shipping-options)
+- [Create Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#create-shipping-option)
 
 ---
 
@@ -296,5 +296,4 @@ Use the same request from Step 2 and verify the count now covers all active, non
 
 ## References
 
-- [Delivery Profiles API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/introduction)
-- [Shipping Options API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/introduction)
+- [API: Shipping Delivery](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping)