assets/:assetId/relationships

Creates relationships between a single asset and one or more entities in other domains within a project.

We will be deprecating this endpoint.

We recommend using the Create Relationships endpoint in the Relationships API. See the Relationships API Field Guide for more details. Note that you need to continue to use this endpoint for creating relationships between assets (asset) and checklists (checklist).

This endpoint accepts an asset ID and an array of one or more entities with which to link.

It creates a separate relationship between the asset and each of the entities in turn, and returns an array with a description of each of the new relationships.

Within BIM 360 projects, you can only link assets to entities of entity types checklist, documentlineage, and issue.

To understand the basics of relationships, and the assets settings that define them, see the Assets Field Guide.

curl -v 'https://developer.api.autodesk.com/bim360/assets/v1/projects/:projectId/assets/6cdd4356-a719-4964-9fd7-0c505e731ac7/relationships' \
  -X 'POST' \
  -H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a' \
  -H 'Content-Type: application/json' \
  -d '{
        "entities": [
          {
            "id": "0212fd8b-8682-465c-a64a-c1dc9a488030",
            "type": "issue",
            "relationshipId": "52d7cecf-9f88-4aa2-b725-a6e09a0bc549"
          }
        ]
      }'

[
  {
    "id": "52d7cecf-9f88-4aa2-b725-a6e09a0bc549",
    "createdOn": "2020-05-01T06:00:00.000Z",
    "isReadOnly": false,
    "isService": true,
    "isDeleted": false,
    "deletedOn": "2020-05-01T06:00:00.000Z",
    "entities": [
      {
        "createdOn": "2020-05-01T06:00:00.000Z",
        "domain": "autodesk-bim360-issue",
        "type": "issue",
        "id": "0212fd8b-8682-465c-a64a-c1dc9a488030"
      }
    ]
  }
]