29 "objectPageException": "This API is internal-only (proto exposure: INTERNAL for its mutating RPCs, ALPHA maturity) -- it has no public dev.wix.com docs object page. Confirmed by two ranked SearchWixRESTDocumentation queries and a full raw API-spec index substring scan for 'wishlist', all returning zero results; the authoritative source is the internal proto itself (see evidence[]).",
43 "surface": "com.wixpress.wishlist.Wishlist (internal proto, package com.wixpress.wishlist)",
44 "endpoint": "POST /v1/wishlists/my",
45 "writerId": null,
46 "verification": "unverified",
47 "importSafe": true,
48 "bulk": false
49 },
50 "fallbacks": [
51 {
52 "classification": "cms",
53 "when": "Always, for a bulk migration import. The native AddToWishlist/RemoveFromWishlist RPCs only operate on 'the default wishlist by context's member' (member-session-scoped, exposure: INTERNAL) -- there is no service-account/backend RPC to write items to an arbitrary existing member's wishlist on their behalf. GetWishlistById/GetWishlists accept a site-level WISHLIST.MANAGE-SITE-WISHLISTS permission but are read-only. A migration script has no member session for historical WooCommerce customers who have never logged into the new Wix site, so the native write path is unusable for import regardless of Alpha status."
54 }
55 ],
56 "reliability": {
57 "status": "unreliable",
58 "flags": ["IMPORT_UNRELIABLE"]
59 },
60 "pitfalls": [
61 {
62 "code": "no-backend-write-path-for-migration",
63 "severity": "blocker",
64 "summary": "Verified against the authoritative internal proto: the fqdn is wix.platform.v1.wishlist (service com.wixpress.wishlist.Wishlist). Its three mutating RPCs (GetWishlist/AddToWishlist/RemoveFromWishlist) are ALPHA maturity, exposure: INTERNAL, and scoped to 'the default wishlist by context's member' -- the caller's own session, not an arbitrary member named by a backend script. The only RPCs open to a site-level manage permission (GetWishlistById, GetWishlists) are read-only. There is no proto-level path for a migration script to write wishlist items on behalf of pre-existing customers who have never authenticated to the new site."
69 "summary": "This is NOT a 'Wix has no surface' gap -- a real native Wishlist entity and proto exist, confirmed live from source. The limitation is specifically the migration-import use case (no backend bulk-write RPC), not an absent feature. Do not record this capability in requires-development.json; it is a documented reliability/fallback case (see fallbacks[] and reliability.flags above), revisitable if Wix adds a service-account write path or a different integration surface (e.g. Velo backend code running with elevated permissions, not yet investigated)."
70 }
71 ],
72 "mappingGuidance": [
73 "Land wishlist data in a Wix CMS collection (cms/collection) for migration imports today -- see fallbacks[]. Revisit this entity if a backend/service-account write RPC is ever added to the Wishlist API."
74 ],
75 "setupRequirements": [
76 "Wix Data (CMS) app, for the fallback collection",
77 "Wix Stores, so wishlist items can reference real migrated product ids"