Page Comparison

Allows getting information about assets in the system.

...

Panel

bgColor	#DEEBFF

Icon legend

This parameter is required

Deprecated

Get single asset

URL: /digizuitecore/legacyservice/api/assets/{assetId}

...

Name	Example	Description
`assetId`	`123456`	The asset id of the asset to get
`metaFieldItemGuids`	`metaFieldItemGuids=6afe78b7-3f24-49f3-bf95-24890ea62696&metaFieldItemGuids=bf0ad1a6-984a-494e-a227-9d70c6a864f9`	Optional query parameter for additional metadata to get for each asset. The metadata response uses the same exact response format as the general metadata editor API. See the metadata response documentation.
`languageId`	`languageId=3`	Optional query parameter to overwrite the language the asset is returned in. If not passed, the language id from the access key will be used.

...

Name	Data type	Example	Description
`itemType`	Enum/int	`0`	The itemType of the asset. Always `0` for assets.
`assetType`	Enum/int	`4` (image)	The asset type of the asset
`assetId`	int	`16`	The `assetId` of the asset. Not to confuse with `itemId`.
`itemId`	int	`9588`	The `itemId` of the asset. Not to confuse with `assetId`
`itemGuid`	String/Guid/UUID	`b05b0e39-2bba-4098-8304-5dac38dff0d8`	The itemGuid of the asset. Basically works like the `itemId`, but is a guid/uuid.
`derivedFrom`	int/null	`null` or `42`	The assetId of the asset this asset is derived from (Cropped or trimmed), or null if this asset is not derived from another asset.
`replacedWith`	int/null	`null` or `42`	The `assetId` of the asset that replaced this asset, or null. This is generally only set for previous versions of assets.
`uploadMemberId`	int	`23`	The id of the user that uploaded this asset.
`hasWriteAccess`	boolean	`true` or `false`	If you are allowed to make changes to this asset.
`fileSize`	int64/long	`45179`	The size in bytes of the source file of this asset
`fileExtension`	string	`jpg`	The file extension of the source file of this asset.
`uploadDate`	DateTime	`2023-05-31T17:36:18.4330000`	A timestamp for when this asset was originally uploaded.
`lastModified`	DateTime	`2023-06-26T15:38:37.9630000`	A timestamp for when this asset was last modified.
`title`	string	`image-11`	The value of the `title` metafield for this asset, in the requested language.
`description`	string	`I am an image`	The value of the `description` metafield for this asset, in the requested language.
`cropName`	string	`banner` or	The name of the crop size that was used for derive this asset, if this asset is a crop of another asset.
`height`	int/null	`1920`	The height in pixels of the source file. Only applicable for file types that has a height.
`width`	int/null	`1080`	The width in pixels of the source file. Only applicable for file types that has a width.
`hashSha1`	string	`7D81F7133CE6A5405A2A2D3E51649435E5428B3E`	The SHA1 hash of the source file of this asset.
`duration`	String/TimeSpan/null	`00:15:42.156`	A dotnet TimeSpan for how long this video/audio file is.
`thumbnailUrl`	string/url/null		A url for a small thumbnail for this asset.
`largeThumbnailUrl`	string/url/null		A larger thumbnail for the asset.
`videoUrl`	string/url/null		A url for streaming this specific asset as video
`audioUrl`	string/url/null		A url for streaming this specific asset as audio.
`pdfUrl`	string/url/null		A url for a pdf rendered version of this asset.
`sourceUrl`	string/url/null		A url for streaming the source file of this asset.
`assetCode`	string	`image-11`	The original file name of the asset, without the extension
`deleted`	boolean	`true` or `false`	bool indicating if this asset has been soft deleted. Soft deleted assets generally won’t be returned in search responses.
`uploadComputer`	string	`Digizuite Media Manager`	The `computerName` that was used when uploading this asset.
`uploadUserName`	string	`contentcreator`	The username of the user that uploaded this asset.
`sourceLocationFileName`	string	`16.jpg`	The filename of the file in the underlying storage. This is usually the asset id + extension.
`sourceLocations`	array		Information about which destinations in the digizuite the source file is available at.
`originalFileName`	string	`image-11`	The original file name of the asset, without the extension.
`transcodes`	array		The transcodes that are available and has currently been generated for this asset.
`transcodes.mediaFormatId`	int	`2`	The id of the mediaFormat this transcode was generated as.
`transcodes.destinationId`	int	`13`	The id of the destination this format is available on.
`transcodes.mediaTranscodeId`	int		The id of the media transcode that was used to generate this media format.
`transcodes.name`	string		The name of this media format
`transcodes.transcodeFileName`	string		The name of the generated file in storage.
`transcodes.url`	string/url/null		A url for streaming this specific format.
`transcodes.md5Hash`	string		An md5 hash of the generated file.
`transcodes.sha1Hash`	string		A SHA1 hash of the generated file.
`additionalMetadata`	dictionary		Any additional metadata that was requested using the `metaFieldItemGuids` parameter. The dictionary is keys by the guid of each metafield. See documentation for each response type here
`lockInfo`	object		Information about the locked/checkout status of the asset.
`lockInfo.assetId`	int		The id of the asset that is locked. Same value as the `assetId` on the root of the response.
`lockInfo.isLocked`	boolean	`true` or `false`	If this file is locked/checked out by someone.
`lockInfo.lockedByMemberId`	int/null		The id of the user that has locked this asset, or null if not locked.
`lockInfo.expirationDate`	DateTimeOffset/null		The date when the lock will automatically open if not renewed before, or null if not locked.
`lockInfo.note`	string/null		An optional note that was passed in when the asset was locked, or null if not locked or no note.

...

Expand

title	Response

Code Block

language	json

{
  "itemType": 0,
  "assetType": 4,
  "assetId": 16,
  "itemId": 9588,
  "itemGuid": "b05b0e39-2bba-4098-8304-5dac38dff0d8",
  "derivedFrom": null,
  "replacedWith": null,
  "uploadMemberId": 23,
  "hasWriteAccess": false,
  "fileSize": 45179,
  "fileExtension": "jpg",
  "uploadDate": "2023-05-31T17:36:18.4330000",
  "lastModified": "2023-06-26T15:38:37.9630000",
  "title": "image-11",
  "description": "I am an image",
  "cropName": "",
  "height": 1920,
  "width": 1080,
  "hashSha1": "7D81F7133CE6A5405A2A2D3E51649435E5428B3E",
  "duration": null,
  "thumbnailUrl": "https://<my-dam>/DigizuiteCore/LegacyService/api/assetstream/16/3.jpg?timestamp=2023-05-31T17%3A38%3A54.9730000&signature=JR2LNitdJoUe4mooGJ4jbs8F5evjP5nCQdNEc8UPNfQTqEKOaA3nl1OH3f5Shu2TpsCW6u5JgiOJzylpewNxTSWooLj2uRxwB7_XvlgvVDFXADq6ls93h2HoaJrbocRWyBKUF2preU7WoE9e__fMc0oy-YhzFTG9pHxye1R1PG0QAAAAAwAAAAAAAACsqgAA",
  "largeThumbnailUrl": "https://<my-dam>/DigizuiteCore/LegacyService/api/assetstream/16/2.jpg?timestamp=2023-05-31T17%3A38%3A54.9730000&signature=I1CB0-JP-h3buM_B0qlKMHIHi3nj4pofj6_HUUttYlzW2Uw7W-Th7kPrtvPQ6p6SdJgWLGEG4QgravmQgFvU5yaB1lEzp6ha0-zQwUZCTZu8IduEjWncu0_9-_oiFsRYD2dM7Rc9hf8eMgxJbRtjtiigPbEadNqlT8S9VLJkWUAQAAAAAgAAAAAAAACsqgAA",
  "videoUrl": null,
  "audioUrl": null,
  "pdfUrl": null,
  "sourceUrl": "https://<my-dam>/DigizuiteCore/LegacyService/api/assetstream/16?timestamp=2023-05-31T17%3A36%3A20.7270000&signature=0OysTXpDEGf5jfq6mTdqRchIL7VSEkuz9E1pU6TzyA3sK9JuNn-4-1BNy8xm0qm01lCg4xLz0mwPXnkHddoq-6qDNdLk26ezYQpdlmpostuXNlkaffHcgXIH40tP9dDlN9NG8susFuYrl8U2jQ5R0CT22mOci6k5ICcszDEWq5UQAAAAAAAAAAAAAACsqgAA",
  "assetCode": "image-11",
  "deleted": false,
  "uploadComputer": "Digizuite Media Manager",
  "uploadUserName": "contentcreator",
  "sourceLocationFileName": "16.jpg",
  "sourceLocations": [
    {
      "locationId": 16,
      "destinationId": 13,
      "location": "00.000.000/00.000/000/16/16.jpg"
    }
  ],
  "originalFileName": "image-11",
  "transcodes": [
    {
      "mediaFormatId": 2,
      "destinationId": 13,
      "mediaTranscodeId": 3,
      "name": "Thumb 1920x1080",
      "transcodeFileName": "16_2.jpg",
      "url": "https://<my-dam>/DigizuiteCore/LegacyService/api/assetstream/16/2.jpg?timestamp=2023-05-31T17%3A38%3A54.9730000&signature=I1CB0-JP-h3buM_B0qlKMHIHi3nj4pofj6_HUUttYlzW2Uw7W-Th7kPrtvPQ6p6SdJgWLGEG4QgravmQgFvU5yaB1lEzp6ha0-zQwUZCTZu8IduEjWncu0_9-_oiFsRYD2dM7Rc9hf8eMgxJbRtjtiigPbEadNqlT8S9VLJkWUAQAAAAAgAAAAAAAACsqgAA",
      "md5Hash": "2FD4E2331874B41C1DE661E5AFAFDB37",
      "sha1Hash": "4EB5465E3999B2A946A57FDC9018361E37313F8A"
    }
    // More results omitted
  ],
  "additionalMetadata": {
    "6afe78b7-3f24-49f3-bf95-24890ea62696": {
      "values": [
        {
          "id": 50226,
          "label": "kat",
          "optionValue": "kat",
          "comboId": 50225
        }
        // More results omitted
      ],
      "type": 169,
      "itemId": 9588,
      "labelId": 10437
    },
    "bf0ad1a6-984a-494e-a227-9d70c6a864f9": {
      "values": [
        {
          "id": 12,
          "label": "Folder C",
          "optionValue": "731ff326-f635-4e84-8035-1fc99277df7e",
          "parentId": null,
          "labelPath": "Folder C",
          "optionValuePath": "731ff326-f635-4e84-8035-1fc99277df7e",
          "treeNodeId": 12,
          "parentTreeNodeId": null,
          "treeNodeIdPath": "12"
        }
        // More results omitted
      ],
      "type": 300,
      "itemId": 9588,
      "labelId": 50749
    }
  },
  "lockInfo": {
    "assetId": 16,
    "isLocked": false,
    "lockedByMemberId": null,
    "expirationDate": null,
    "note": null
  }
}

Bulk get assets

URL: /digizuitecore/legacyservice/api/assets/bulk-get

...

Name	Example	Description
`assetIds`	`[123456, 789456]`	The asset ids of the assets to get.
`itemIds`	`[456123, 456789]`	The item ids of the assets to get.
`itemGuids`	`["2D569054-068E-4396-9773-F906CFDA70E0", "78B778DB-DDDF-4555-A833-7506704A3D66"]`	The item guids of the assets to get.
`metaFieldItemGuids`	`metaFieldItemGuids=6afe78b7-3f24-49f3-bf95-24890ea62696&metaFieldItemGuids=bf0ad1a6-984a-494e-a227-9d70c6a864f9`	Optional parameter for additional metadata to get for each asset. The metadata response uses the same exact response format as the general metadata editor API. See INSERT LINK HERE!!!!
`languageId`	`languageId=3`	Optional parameter to overwrite the language the asset is returned in. If not passed, the language id from the access key will be used.

...

Versions Compared

Old Version 4

New Version 5

Key

Get single asset

Bulk get assets