Mapping 3D nodes to asset-centric assets is deprecated. Link 3D objects to CogniteAsset with the 3D contextualization APIs. These endpoints are in public preview. The Python SDK does not include these endpoints yet, so call them over HTTP. 3D model upload stays available. You can upgrade 3D models and mappings with the migration plugin.See Data modeling status for CDF projects for how 3D behavior differs between
DATA_MODELING_ONLY and HYBRID projects.Why map nodes to assets?
Mapping 3D nodes to assets lets you:- Navigate from 3D to data — Click a node in a 3D view to see its associated time series, events, or files
- Navigate from data to 3D — Start from an asset and locate its representation in one or more 3D models
- Enrich visualizations — Display live asset data alongside 3D geometry
Mapping rules
Each request filters by one type only:assetId, nodeId, or intersectsBoundingBox on retrieve, and assetIds, nodeIds, or treeIndexes on list.
A nodeId filter returns only nodes that exist. An assetId filter returns every stored mapping, including a mapping whose asset no longer exists. GET /3d/mappings/{assetId}/modelnodes omits a mapped node that is missing. An asset named in a mapping is not guaranteed to exist.
In a hybrid project, responses include nodeId and assetId mappings. Set getDmsInstances to true to return assetInstanceId mappings instead. Creating a mapping does not check that the asset ID exists. The mapping stays until you delete that assetId and nodeId pair.
In a data modeling only project, these mapping endpoints are not available. Query CogniteCADNode through data modeling. When a create call does accept an assetInstanceId, that instance and the revision node must both exist.
Key operations
You can create mappings, update them, and query them in several ways:- Filter by bounding box — Find nodes within a spatial region
- Find mappings for an asset — Retrieve all 3D mappings for a given asset across models
Asset mappings are per-model and per-revision. When you update a revision, you may need to recreate or verify mappings.