Resource loc:referencing-items

Overview

The loc:referencing-items resource contains the location items that reference an asset.

Properties

The loc:referencing-items resource has no properties.

Link Relations

aa:asset

A link to the asset.

loc:item

Links to all location items that reference the asset.

Description

The loc:referencing-items resource contains the location items that reference an asset.

This is typically used to find the references to an asset in all folders of the entire folder hierarchy. Note that the result does not contain the folders, but the asset reference items within the folders. You can follow the loc:path link of those items to get to the folders.

Examples

Referencing items for a MediaCentral Asset Management asset that is referenced by two items in different folders: 
 
{
  "_links": {
    "curies": [
      {
        "href": "http://services.avid.com/apis/locations/{rel}",
        "name": "loc",
        "templated": true
      },
      {
        "href": "http://services.avid.com/apis/assets/{rel}",
        "name": "aa",
        "templated": true
      }
    ],
    "self": {
      "href": "https://host/…​"
    },
    "aa:asset": {
      "href": "https://host/…​"
    },
    "loc:item": [
      {
        "href": "https://host/…​"
      },
      {
        "href": "https://host/…​"
      }
    ]
  },
  "_embedded": {
    "loc:item": [
      {
        "base": {
          "id": "100.102",
          "type": "folder-item",
          "systemType": "interplay-mam",
          "systemID": "ea836abc-105a-11ea-8d71-362b9e155667"
        },
        "common": {
          "name": "Bear MPG",
          "creator": "admin",
          "created": "2017-02-14T15:27:49.56+01:00",
          "modifier": "admin",
          "modified": "2017-02-14T15:27:49.56+01:00"
        },
        "_links": {
          "self": {
            "href": "https://host/…​"
          },
          "profile": {
            "href": "https://host/…​"
          },
          "loc:update-item": {
            "href": "https://host/…​"
          },
          "loc:path-to-root": {
            "href": "https://host/…​"
          }
        }
      },
      {
        "base": {
          "id": "2.4162",
          "type": "folder-item",
          "systemType": "interplay-mam",
          "systemID": "ea836abc-105a-11ea-8d71-362b9e155667"
        },
        "common": {
          "name": "Bear MPG",
          "creator": "admin",
          "created": "2017-07-11T12:38:40.113+02:00",
          "modifier": "admin",
          "modified": "2017-07-11T12:38:40.113+02:00"
        },
        "_links": {
          "self": {
            "href": "https://host/…​"
          },
          "profile": {
            "href": "https://host/…​"
          },
          "loc:update-item": {
            "href": "https://host/…​"
          },
          "loc:path-to-root": {
            "href": "https://host/…​"
          }
        }
      }
    ]
  }
}