Retrieve Binary Versions

/dam/assets/versions/bin Retrieves the binary data of asset version.
Table 1. Details

Resource path

/api/core/v1/dam/assets/versions/bin

HTTP method

POST

Request content type

Request params

Response content type

application/octet-stream
Body parameters

Specified by request URL params

  • assetTid - (String) - tid of asset

  • assetId - (Integer) - identity of asset

  • format - (String) - type of version preview

  • versionNumber - (Integer) - number of version

  • versionTid - (String) - tid of version

Return Type

Binary data of asset version file.

Responses
Table 2. Http response codes
Code Message Datatype

200

OmnType with list of keywords

OmnType

404

The requested resource could not be found

ResponseType

500

An unknown internal error occurred

ResponseType
Samples
1. Retrieve binary version by assetId
curl
curl --location --request POST 'http://<OMN_SERVER>/api/core/v1/dam/assets/versions/bin?assetId=<ASSET_IDENTITY>&versionNumber=<VERSION_NUMBER>' \
--header 'Authorization: Bearer <TOKEN> ' \
--data-raw ''

Request params:

assetId=12345, versionNumber=1

Response body:

apollon_logo_original.png
2. Retrieve binary version by assetTid
curl
curl --location --request POST 'http://<OMN_SERVER>/api/core/v1/dam/assets/versions/bin?assetTid=<ASSET_TID>&versionNumber=<VERSION_NUMBER>' \
--header 'Authorization: Bearer <TOKEN> ' \
--data-raw ''

Request params:

assetId=B29ECF60-0AB0-431D-8510-94490F27B229, versionNumber=1

Response body:

apollon_logo_original.png
3. Retrieve version preview by version tid and preview type
curl
curl --location --request POST 'http://<OMN_SERVER>/api/core/v1/dam/assets/versions/bin?versionTid=<VERSION_TID>&format=<PREVIEW_FORMAT>' \
--header 'Authorization: Bearer <TOKEN> ' \
--data-raw ''

Request params:

versionTid=B29ECF60-0AB0-431D-8510-94490F27B229, previewType=previewThumbnail

Response body:

thumbnail.png

Welcome to the AI Chat!

Write a prompt to get started...