v1

latestOpenAPI 3.1.02026-07-2419782400.4 KB
Media download

Retrieve asset download location

Retrieve the download location for an asset. Warning: Requires the MEDIAHIGHRES security role. Warning: Requires the ARCHIVEDOWNLOAD security role if the asset in question is archived. Warning: Requires the DOWNLOADWATERMARK security role if the asset in question is watermarked. Warning: Requires the KEYVISUALSDOWNLOAD security role if the asset in question is marked as limited usage.

get/api/v4/media/{id}/download

Path parameters

idstring required
Example:00000000-0000-0000-0000000000000000

Query parameters

type'original' | 'additional'

Response

URL from which you can download the requested asset file.

disclaimerstring
s3_filestring

Example response

{
  "disclaimer": "<p>1. The photographs and video in the mediabank are to be used by anyone and everyone.</p>",
  "s3_file": "___TEMPORARY_DOWNLOAD_URL___"
}