List every location an asset is referenced
One asset can be referenced from many places at once — its own folder, the reviewer tree, any submission it was added to, any public release it was shared in. They all point at the same asset, which is why renaming it retitles it everywhere, and why deleting the last reference in its primary file system removes the rest. PRIMARY references are the asset's home file system; SECONDARY are everything else, grouped by collection. Only collections with at least one reference appear in `counts`.
One asset can be referenced from many places at once — its own folder, the reviewer tree, any submission it was added to, any public release it was shared in. They all point at the same asset, which is why renaming it retitles it everywhere, and why deleting the last reference in its primary file system removes the rest.
PRIMARY references are the asset's home file system; SECONDARY are everything else, grouped by collection. Only collections with at least one reference appear in counts.
OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.
In: header
Scope: assets:read
Path Parameters
The ID of the asset
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/references"{ "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8", "assetName": "string", "everPublic": true, "primaryRoot": "string", "primary": [ { "fileSystemId": "b1428d76-db1d-49f6-99a8-028a6fc81c52", "path": "string", "itemPath": "string", "createdAt": "2019-08-24T14:15:22Z" } ], "secondary": { "reviewer": [ { "fileSystemId": "b1428d76-db1d-49f6-99a8-028a6fc81c52", "kind": "reviewer", "path": "string", "itemPath": "string", "label": "string", "createdAt": "2019-08-24T14:15:22Z", "releaseStatus": "active" } ], "submission": [ { "fileSystemId": "b1428d76-db1d-49f6-99a8-028a6fc81c52", "kind": "reviewer", "path": "string", "itemPath": "string", "label": "string", "createdAt": "2019-08-24T14:15:22Z", "releaseStatus": "active" } ], "public": [ { "fileSystemId": "b1428d76-db1d-49f6-99a8-028a6fc81c52", "kind": "reviewer", "path": "string", "itemPath": "string", "label": "string", "createdAt": "2019-08-24T14:15:22Z", "releaseStatus": "active" } ], "other": [ { "fileSystemId": "b1428d76-db1d-49f6-99a8-028a6fc81c52", "kind": "reviewer", "path": "string", "itemPath": "string", "label": "string", "createdAt": "2019-08-24T14:15:22Z", "releaseStatus": "active" } ] }, "counts": {}, "secondaryCount": 0}