Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Endpoint ID:

9101

Method:

Status
colourGreen
titlePUT

URL:

/content/media

Request body:

JSON data with information about the media to be updated.

Required fields:
 

fileName

A The media file name or title of the media item.

Optional fields:
 folderPathA The 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. Exclude the folderPath to update a file in the root folder.
Optional updatable fields:
 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". The content type may only be changed to another content type with the same resulting media file type - that is, an Image media file with content type "image/gif" may be changed to "image/png", but not to "text/css".

Code Block
titleExample: Update a single pixel image
 {
   "fileName": "clear_1x1.gif",
   "folderPath": "assets/generic_images/small",
   "content": "R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==",
   "description" : "This is a media description.",
   "contentType": "image/gif"
}

Response body:

None

Status codes:

204

Media updated successfully.

 404Media file not found.
 400.1Content type not recognized
 400.2Media files may not be larger than 2MB
 400.3Altering 'contentType' may not result in a different media file type