List 3D asset mappings

Lists 3D assets mappings that match the ID for the specified filter query parameter type. Only one type of filter can be specified for each request, either assetId, nodeId or intersectsBoundingBox.

In Hybrid CDF projects: The nodeId and assetId mappings are returned by default. To instead see any assetInstanceId mappings (for CoreDM based contextualization), set the getDmsInstances query parameter to true.

In DataModelingOnly CDF projects: This endpoint is not available. Use DMS queries to list CogniteCADNodes.

Note: When filtering for a specific nodeId, only nodeIds that actually exists will be returned. When filtering for a specific assetId, all mappings will be returned, even if the assetId does not exist.

Securityoidc-token or oauth2-client-credentials or oauth2-open-industrial-data or oauth2-auth-code
Request
path Parameters
modelId
required
integer <int64>

Model ID.

revisionId
required
integer <int64>

Revision ID.

query Parameters
cursor
string

Cursor for paging through results.

Example: cursor=4zj0Vy2fo0NtNMb229mI9r1V3YG5NBL752kQz1cKtwo
limit
integer [ 1 .. 1000 ]
Default: 100

Limits the number of results to be returned. The maximum results returned by the server is 1000 even if you specify a higher limit.

nodeId
integer <int64>
assetId
integer <int64>
intersectsBoundingBox
string

Example: {"min":[0.0, 0.0, 0.0], "max":[1.0, 1.0, 1.0]}

If given, only return asset mappings for assets whose bounding box intersects the given bounding box.

Must be a JSON object with min, max arrays of coordinates.

getDmsInstances
boolean
Default: false

If true, the response will include any assetInstanceId instances for the mappings.

Responses
200

A list of mappings between assets and 3D nodes

400

The response for a failed request.

get/3d/models/{modelId}/revisions/{revisionId}/mappings
Request samples
const mappings3D = await client.assetMappings3D.list(3244265346345, 32423454353545);
Response samples
application/json
{
  • "items": [
    • {
      }
    ],
  • "nextCursor": "string"
}