Category

1{
2  "schemaVersion": 1,
3  "domain": "events",
4  "entity": "category",
5  "displayName": "Events Category",
6  "capability": "content.event-categories",
7  "target": {
8    "classification": "native",
9    "nativeEntity": "Wix Events Category",
10    "verifiedFqdn": "wix.events.v1.category",
11    "idPolicy": "server-assigned",
12    "crosswalkRequired": true
13  },
14  "sourceAliases": [
15    {
16      "sourceSystem": "wordpress",
17      "sourceEntity": "tribe_events_cat",
18      "routes": [
19        "/wp/v2/tribe_events_cat"
20      ],
21      "confidence": "high"
22    }
23  ],
24  "preferredWrite": {
25    "surface": "Events Categories",
26    "endpoint": "POST /events/v1/categories",
27    "writerId": null,
28    "verification": "verified-live",
29    "importSafe": true,
30    "bulk": false
31  },
32  "fallbacks": [
33    {
34      "classification": "cms",
35      "when": "Only if category metadata beyond name/assignment must survive (Wix category carries name + assigned events)."
36    }
37  ],
38  "reliability": {
39    "status": "unknown",
40    "flags": []
41  },
42  "mappingGuidance": [
43    "Create categories first, then assign events to them by ID — assignment happens on the category, not the event.",
44    "Wix Events categories are flat: flatten hierarchical source taxonomies and record the faithfulness-ledger entry."
45  ],
46  "setupRequirements": [
47    "Wix Events app"
48  ],
49  "pitfalls": [
50    {
51      "code": "flat-categories",
52      "severity": "warning",
53      "summary": "Wix Events categories are flat; a hierarchical source event taxonomy (tribe_events_cat is hierarchical) flattens on import — faithfulness-ledger entry required."
54    }
55  ],
56  "notes": "Surfaced by the mapping review 2026-08-10: the mapper proposed CMS for event categories and the reviewer pointed at the native Categories API (dev.wix.com Events > Event Management > Categories). Docs-verified only; exercise live before confirming.",
57  "evidence": [
58    {
59      "type": "wix-docs",
60      "url": "https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/categories/category-object"
61    },
62    {
63      "type": "review-decision",
64      "path": "supplied by the reviewer (Spec Owner) at the mapping review, 2026-08-10"
65    },
66    {
67      "type": "live-run",
68      "path": "migrations/probe-run-20260812/execution/verification.json",
69      "note": "subset run imp_msq0ugnj_f0b16c (2026-08-12): create + query-back readback, safe mode on — 3/3 categories created via POST /events/v1/categories, server IDs crosswalked; assignment-to-events not exercised (events stayed drafts)"
70    }
71  ]
72}