Media Upload

Overview

The Media Upload endpoint allows you to manage your Hosted Items, by uploading new Hosted Items, or by requesting information about, or updating, existing Hosted Items.

  • Endpoint (North America): https://api.eccmp.com/services2/api/MediaUpload

  • Endpoint (Europe): https://api.ccmp.eu/services2/api/MediaUpload

  • Endpoint (Japan): https://api.marketingsuite.jp/services2/api/MediaUpload

For more details on the Media Upload API, please see the Media Upload / Hosted Item API Technical Guide.

GET Method

The Media Upload endpoint supports the following GET operation. This endpoint allows you to retrieve the URL for a specified Hosted Item by providing its Object Reference ID.

Click here to see a sample response message in JSON format.

POST Method

The Media Upload endpoint supports the following POST operation. This endpoint allows you to upload a new Hosted Item by providing the following basic information:

  • Your Customer ID.

  • The Hosted Item's display name within the application. This name can't contain any spaces or special characters, except for underscores. It also must contain one of the following supported file extensions: .jpeg, .jpg, .gif, .bmp, .png, .htm, html, and .zip.

  • The Folder ID of the folder where you want to save the new item. Please note that Hosted Items use a different folder structure than the folders where you save other Cheetah Digital assets, like Filters or Campaigns. Hosted Items have their own unique folder structure, and their own unique item type. When looking up Hosted Item folders using theSearchendpoint, you must use the item type "WebFiles," rather than "Folders." You can also used the Hosted Item endpoint to look up Folder IDs for Hosted Item folders.

  • The encoding method -- this must be "base64."

  • The Base64-encoded contents of the file.

Click here to see a sample request message in JSON format.

PUT Method

The Media Upload endpoint supports the following PUT operation. This endpoint allows you to replace an existing Hosted Item with an updated version. The request message must include the Hosted Item's Object Reference ID, and the Base64-encoded data for the new version.

Note: You can't change the Hosted Item's name or location.

Click here to see a sample request message in JSON format.