Data Item

1{
2  "schemaVersion": 1,
3  "domain": "cms",
4  "entity": "data-item",
5  "displayName": "CMS Data Item",
6  "target": {
7    "classification": "cms",
8    "nativeEntity": "Wix Data Item",
9    "verifiedFqdn": "wix.data.v2.data_item",
10    "idPolicy": "client-assigned",
11    "crosswalkRequired": false
12  },
13  "sourceAliases": [
14    { "sourceSystem": "wordpress", "sourceEntity": "custom_post_type_item", "routes": ["/wp/v2/{type}"], "confidence": "medium" },
15    { "sourceSystem": "wix", "sourceEntity": "cmsDataItem", "routes": ["Wix Data Items"], "confidence": "high" }
16  ],
17  "preferredWrite": {
18    "surface": "Wix Data Items",
19    "endpoint": "POST /wix-data/v2/items",
20    "writerId": "insertDataItem",
21    "verification": "verified-live",
22    "importSafe": true,
23    "bulk": false
24  },
25  "fallbacks": [],
26  "reliability": { "status": "reliable", "flags": [] },
27  "pitfalls": [
28    { "code": "readonly-dates", "severity": "warning", "summary": "_createdDate and _updatedDate are read-only; preserve source dates in explicit fields." },
29    { "code": "bulk-save-replaces", "severity": "warning", "summary": "Bulk Save replaces complete items, so generated records must include all fields." }
30  ],
31  "mappingGuidance": ["Use client-supplied IDs where possible for recoverable CMS imports."],
32  "setupRequirements": ["Wix Data enabled", "Target collection exists before item writes."],
33  "evidence": [
34    { "type": "repo-research", "path": "research/import-api-suitability/blog-cms-media.md" }
35  ]
36}