library

Upload Media from URL

Changed on

Upload Media to CMS library from an external URL

post/library/uploadUrl

Request

  • Base URL
    /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/library/uploadUrl
  • Auth
    none declared

Request body application/x-www-form-urlencoded

urlstring required

The URL to the media

typestring required

The type of the media, image, video etc

extensionstring

Optional extension of the media, jpg, png etc. If not set in the request it will be retrieved from the headers

enableStatstring

The option to enable the collection of Media Proof of Play statistics, On, Off or Inherit.

optionalNamestring

An optional name for this media file, if left empty it will default to the file name

expiresstring

Date in Y-m-d H:i:s format, will set expiration date on the Media item

folderIdinteger

Folder ID to which this media should be assigned to

Response

successful operation

mediaIdinteger

The Media ID

ownerIdinteger

The ID of the User that owns this Media

parentIdinteger

The Parent ID of this Media if it has been revised

namestring

The Name of this Media

mediaTypestring

The module type of this Media

storedAsstring

The file name of the media as stored in the library

fileNamestring

The original file name as it was uploaded

fileSizeinteger

The file size in bytes

durationinteger

The duration to use when assigning this media to a Layout widget

validinteger

Flag indicating whether this media is valid.

moduleSystemFileinteger

DEPRECATED: Flag indicating whether this media is a system file or not

expiresinteger

Timestamp indicating when this media should expire

retiredinteger

Flag indicating whether this media is retired

isEditedinteger

Flag indicating whether this media has been edited and replaced with a newer file

md5string

A MD5 checksum of the stored media file

ownerstring

The username of the User that owns this media

groupsWithPermissionsstring

A comma separated list of groups/users with permissions to this Media

groupsWithPermissionsListstring[]

An array of groups/users with permissions to this Media

releasedinteger

A flag indicating whether this media has been released

apiRefstring

An API reference

createdDtstring

The datetime the Media was created

modifiedDtstring

The datetime the Media was last modified

enableStatstring

The option to enable the collection of Media Proof of Play statistics

orientationstring

The orientation of the Media file

widthinteger

The width of the Media file

heightinteger

The height of the Media file

folderIdinteger

The id of the Folder this Media belongs to

permissionsFolderIdinteger

The id of the Folder responsible for providing permissions for this Media

Changes

  • 622fb073aecdRevision changes
    • info

      added the optional property to the response with the status

  • 41c04de98ec5Revision changes
    • breaking

      added required request body

    • info

      added the media type application/json for the response with the status