Generates a URL for downloading a compressed file containing specific files in the Media Manager.

The compressed file can contain up to 1000 files.

Generates one or more temporary URLs for downloading a specific file in the Media Manager.

To download different assets of the file, use the assetKeys parameter which generates a download URL for each asset. If no assetKey is specified, it defaults to src, which generates one download URL in the original file's format and quality.

Use this endpoint to grant external clients access to a private media file. Use the expirationInMinutes parameter to set the URL expiration time, and the expirationRedirectUrl parameter to add a redirect url when the URL expires.

Gets information about a specific file in the Media Manager.

Updates a file.

Deprecation Notice:

This endpoint has been replaced with Update File Descriptor and will be removed on March 31, 2023.

You can use the parentFolderId parameter to move a file from its current folder to a different folder.

Gets information about specific files in the Media Manager.

Updates a file.

You can use the parentFolderId parameter to move a file from its current folder to a different folder.

Generates an upload URL to allow external clients to upload a file to the Media Manager.

To learn how external clients can use the generated upload URL in the response to upload a file to the Media Manager, see the Upload API article.

Note: Any interruption in the upload process stops the file upload. For files larger than 10MB, or when network connection is poor, use the Generate File Resumable Upload Url instead. With the resumable upload URL, any interruption in the upload process pauses the file upload, and resumes the file upload process after the interruption.

Generates a resumable upload URL to allow external clients to easily upload large files over 10MB to the Media Manager.

With the resumable upload URL, any interruptions in the upload process pauses the file upload, and resumes the file upload process after the interruption. The resumable upload URL is also helpful when network connection is poor. To learn how external clients can use the generated upload URL in the response to upload large files to the Media Manager, see the Resumable Upload API article.

Imports a file to the Media Manager using an external url.

Returns information about the imported file. Use the parentFolderId parameter to specify which folder you want the file to be imported to. If no folder is specified, the file is imported to the media-root folder.

To import a file, you need to provide one of the following:

1. Pass the file's MIME type in the mimeType parameter of the request. For example, 'image/png'.
2. Pass the file's name and extension. For example, 'my-image.png'.
3. If you don't know the file's extension or MIME type, pass its media type in the mediaType parameter of the request. For example, 'IMAGE'. Note that this option only works if the server hosting the media allows a 'HEAD' request.

Note: The media property isn't returned in the files response object.

Imports a bulk of files to the Media Manager using external urls.

Returns information about the imported files. Use the parentFolderId parameter to specify in which folder you want each file to be imported to. If no folder is specified, the file is imported to the media-root folder.

To import files, you need to provide one of the following:

1. Pass each file's MIME type in the mimeType parameter of the request. For example, 'image/png'.
2. Pass each file's name and extension. For example, 'my-image.png'.
3. If you don't know a file's extension or MIME type, pass its media type in the mediaType parameter of the request. For example, 'IMAGE'. Note that this option only works if the server hosting the media allows a 'HEAD' request.

Note: The media property isn't returned in the files response object.

Retrieves a list of files in the Media Manager.

To retrieve a list of files within a specific folder in the Media Manager, pass the folder's ID in the parentFolderId parameter. If no folder is specified, the endpoint retrieves the list of files in the root folder of the Media Manager.

Searches all folders in the Media Manager and returns a list of files that match the terms specified in the parameters.

If no parameters are specified, the endpoint returns all files in the MEDIA_ROOT folder.

Generates a URL for streaming a specific video file in the Media Manager.

To stream different assets of the file, use the assetKeys parameter which generates a video streaming URL for each asset. If no assetKey is specified, it defaults to src, which generates one video streaming URL in the original file's format and quality.

Deletes the specified files from the Media Manager.

The deleted files are moved to the Media Manager's trash bin (TRASH-ROOT folder) unless permanently deleted. To permanently delete files, pass the permanent parameter with the value true. Permanently deleting files isn't reversible, so make sure that these files aren't being used in a site or in any other way as the files will no longer be accessible.

Note the following:

• The specified files can be from different folders.
• Moving multiple files at once is an asynchronous action, and may take time for the changes to appear in the Media Manager.
• Attempting to delete files that are already in the trash bin doesn't result in an error.
• If your site contains deleted media files, the deleted media files still appear on your site as the files are still in the Media Manager (in the trash bin).
• You can use the Bulk Restore Files From Trash Bin endpoint to restore files from the Media Manager's trash bin.

Restores the specified files from the Media Manager's trash bin, and moves them to their original locations in the Media Manager.

Retrieves a list of files in the Media Manager's trash bin.

Note: The Media Manager's trash bin (TRASH-ROOT folder) only contains temporarily deleted files, not permanently deleted files.

Triggered when a file is updated, including when a file is moved to a different folder.

Triggered when a file is deleted.

If the movedToTrash property in the event object true, the file was moved to the Media Manager's trash bin. If the movedToTrash property in the event object is false, the file was permanently deleted.

Triggered when a file is ready to be used, after any post-upload processing.

This event is also triggred when a file is restored from the Media Manager's trash bin.

Triggered when a file fails during essential post-upload processing.