Skip to main content
The 3D contextualization APIs create and remove links between 3D domain objects and CogniteAsset instances in data modeling projects. These links are scoped to specific 3D model revisions and let you navigate between 3D content and related assets.
These endpoints are available only in data modeling projects.

​
What these endpoints do

The group covers three contextualization types:
  • CAD nodes to assets for a specific CAD model revision
  • 360 image annotations to assets for a specific 360 image revision (one CogniteAsset to many Cognite360ImageAnnotation)
  • Point cloud volume references to assets for a specific point cloud revision
Each type has a create endpoint and a delete endpoint for managing those links.

​
Relationship rules

CAD contextualization is one asset to many nodes, and one node to one asset. A CogniteCadNode can link to a single CogniteAsset. A CogniteAsset can link to many CAD nodes. Nodes are scoped to the model revision you name. Asset references use the space and externalId of the CogniteAsset. 360 image contextualization links one CogniteAsset to many Cognite360ImageAnnotation instances in one revision. Use the request body variants whose names include RC. The variants without RC are deprecated and will be removed before the endpoint is released. Point cloud contextualization links volume references to CogniteAsset instances in one point cloud revision.

​
How this relates to 3D asset mapping

These APIs link 3D objects to CogniteAsset instances in data modeling spaces. 3D asset mapping maps 3D model nodes to Cognite Data Fusion (CDF) assets for bidirectional navigation between 3D views and asset data.

​
APIs in this group

​
CAD contextualization

  • Create links between CAD nodes and CogniteAsset instances
  • Delete specified CAD-node contextualizations for the referenced model revision

​
360 image contextualization

  • Create links between 360 image annotations and CogniteAsset instances
  • Delete the CogniteAsset and Cognite360ImageAnnotation annotation pair links for the referenced revision

​
Point cloud contextualization

  • Create links between point cloud volume references and CogniteAsset instances
  • Delete specified volumeReferences contextualizations for the referenced point cloud revision
Last modified on November 2, 2026