BYbynder
Media download

Retrieve specific asset item download location

Retrieve the download location for a specific asset item. 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/{itemId}

Request

  • Base URL
    https://{your-bynder-domain}
  • URL
    https://{your-bynder-domain}/api/v4/media/{id}/download/{itemId}
  • Auth
    • OAuth 2
      Authorization code: https://{your-auth-url}
      Client credentials
      Token URL: https://{your-bynder-domain}/v6/authentication/oauth2/token scopes: MEDIAHIGHRES, ARCHIVEDOWNLOAD, DOWNLOADWATERMARK, KEYVISUALSDOWNLOAD
    • or API key in header Authorization

Path parameters

idstring required
Example:00000000-0000-0000-0000000000000000
itemIdstring required
Example:00000000-0000-0000-0000000000000000

Query parameters

hashboolean

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___"
}

Changes

No recorded changes to this operation across all 1 revision of this API.