Excerpt |
---|
Update a media file to the dialogportal™ Media Archive. |
Media A media in the archive is contained in a folder structure, and file and folder names are unique within their respective folders.
When attempting to create a media file with a name that already exists in the folder, the autoName
field is used to determine the correct action. When autoName
is omitted or set to false
, a 303 response will be returned including a location
header containing the URL to the existing media file. When autoName
is true
, the file will be created with an auto-incremented "index" appended to the file name, "file_1.txt", "file_2.txt" etc.
To add new folders simply include them in your folderPath
. Folders that do not already exist will be created.
archive can be searched and updated based on fileName and folderPath fields.
Fields - content, contentType and description are optional fields that can be updated. If a field is omitted, then this field is not updated. If all three fields (content, contentType and description) are omitted, then nothings get updated.
Endpoint ID: | 9101 | |||||||||||||||||||||||||||
Method: |
| |||||||||||||||||||||||||||
URL: | /content/media | |||||||||||||||||||||||||||
Request body: | JSON data with information about the media to be updated.
| |||||||||||||||||||||||||||
Response body: |
The URL format is:
| |||||||||||||||||||||||||||
Status codes: | 201200 | Media created updated successfully. | ||||||||||||||||||||||||||
303 | 404 | Media to be updated not found. | ||||||||||||||||||||||||||
400.1 | Content type not recognized | |||||||||||||||||||||||||||
400.2 | Media files may not be larger than 2MB |