Create CAD contextualization

Create contextualization links between 3D CAD nodes and CogniteAsset instances. Use this endpoint to connect CAD objects in a specific 3D model revision to assets in data modeling projects. These links let users navigate between 3D objects in a 3D CAD model and their connected CogniteAsset instances.

This API enforces a strict one-to-many relationship between assets and CAD nodes: a CogniteCadNode can only be connected to a single CogniteAsset, while a CogniteAsset can be connected to multiple CAD nodes.

The CAD nodes are scoped to the referenced 3D model revision. Asset references use the space and externalId of CogniteAsset instances.

Note: This endpoint is available only in data modeling projects.

Securityoidc-token or oauth2-client-credentials or oauth2-open-industrial-data or oauth2-auth-code
Request
Request Body schema: application/json

The list of asset instanceIds and nodes, and the dmsContextualizationConfig.

required
Array of objects (CreateCADContextualizationList) [ 1 .. 100 ] items
required
object (DmsContextualizationConfigRC)
Responses
200

Empty response.

400

The response for a failed request.

post/3d/contextualization/cad
Request samples
application/json
{
  • "items": [
    • {
      }
    ],
  • "dmsContextualizationConfig": {
    • "object3DSpace": "string",
    • "contextualizationSpace": "string",
    • "revision": {
      }
    }
}
Response samples
application/json
{ }
➔ Next to Create point cloud volume contextualization