Category

1{
2  "schemaVersion": 1,
3  "domain": "blog",
4  "entity": "category",
5  "displayName": "Blog Category",
6  "target": {
7    "classification": "native-plus-cms",
8    "nativeEntity": "Blog Category",
9    "verifiedFqdn": null,
10    "idPolicy": "server-assigned",
11    "crosswalkRequired": true
12  },
13  "sourceAliases": [
14    { "sourceSystem": "wordpress", "sourceEntity": "category", "routes": ["/wp/v2/categories"], "confidence": "high" },
15    { "sourceSystem": "wix", "sourceEntity": "blogCategory", "routes": ["Blog Categories"], "confidence": "high" }
16  ],
17  "preferredWrite": {
18    "surface": "Blog Categories",
19    "endpoint": "POST /blog/v3/categories",
20    "writerId": "createBlogCategory",
21    "verification": "verified-live",
22    "importSafe": true,
23    "bulk": false
24  },
25  "fallbacks": [
26    { "classification": "cms", "when": "Use to preserve WordPress category hierarchy because Wix Blog categories are flat." }
27  ],
28  "reliability": { "status": "partially-reliable", "flags": [] },
29  "pitfalls": [
30    { "code": "flat-target", "severity": "warning", "summary": "Wix Blog categories are flat; WordPress hierarchy needs CMS shadowing if it matters." }
31  ],
32  "mappingGuidance": ["Resolve category collisions and crosswalk IDs before writing posts."],
33  "setupRequirements": ["Wix Blog app"],
34  "evidence": [
35    { "type": "repo-research", "path": "research/import-api-suitability/blog-cms-media.md" }
36  ]
37}