Create 3D asset mappings

Create asset mappings

Asset mappings allows connections to be made between assets and 3D nodes. This can be used to contextualize 3D models.

In Hybrid CDF projects: Asset IDs obtained from a mapping may be invalid, and not point to real asset IDs. The assetId existence is not checked by any means by the 3D API. The mappings will be stored until an assetId and nodeId pair is removed through the mappings delete endpoint.

In DataModelingOnly CDF projects: When creating asset mappings, the data model based assetInstanceId (with space and externalId), and the 3d model revision nodeId, must be accessible, existing and valid.

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.

Request Body schema: application/json
required

The asset mappings to create.

One of:
required
Array of objects (CreateAssetMapping3D) [ 1 .. 1000 ] items
Responses
201

A list of created asset mappings.

400

The response for a failed request.

post/3d/models/{modelId}/revisions/{revisionId}/mappings
Request samples
application/json
{
  • "items": [
    • {
      }
    ]
}
Response samples
application/json
{
  • "items": [
    • {
      }
    ]
}