Page Comparison

...

Endpoint ID:

9101

Method:

Status

colour	Green
title	PUT

URL:

/content/media

Request body:

JSON data with information about the media to be updated.

Required fields:
	fileName	A file name or title of the media item.
	folderPath	A folder path of the media file to be updated. This path is not the entire URL (which also contains the customer name, fileName etc.) but simply a `"/"`-delimited string of folder names.
Optional fields to be updated:
	content	The content, formatted as a base64 encoded text string.
	description	A description that will be displayed in dialogportal™
	contentType	The content mime-type, i.e. "image/gif" or "text/plain".

Code Block

title	Example: Create a single pixel image

 {
   "content": "R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==",
   "description" : "This is a media description.", 
   "contentType": "image/gif",
   "fileName": "clear 1x1.gif",
   "folderPath": "Assets/Generic Images/Small",
   "autoName" :
true
}

Response body:

A JSON object containing the url to the newly created updated content.

Code Block

title	Example

{
  "url": "https://media.dialogportal.com/customer_name/assets/generic_images/small/clear_1x1.gif"
}

The URL format is:

Base URL	`https://media.dialogportal.com/`
Customer name	customer_name/
Folder path	assets/generic_images/small/
File name	`clear_1x1.gif`

Note
The `fileName` and `folderPath` have been sanitized, making them safe to use in a URL.

Status codes:

201

Media created successfully.

303

A media file with this name already exists in the folder.

The response includes a location header containing the URL to the existing media file.

400.1 Content type not recognized

400.2 Media files may not be larger than 2MB

Versions Compared

Old Version 3

New Version 4

Key