Skip to main content
The Media Cloud API lets your application upload files, list them, fetch their metadata and URLs, and remove them when they are no longer needed. A typical integration looks like this:
1

Upload

Send a file, or several at once, as multipart/form-data. Media Cloud returns an asset for each file.
2

Serve

Use the asset’s url, thumbnail_url or download_url to display or download the file.
3

Clean up

Move assets to the trash, then permanently delete them when you are sure.

​
Base URL

Every route is mounted under /api/v1 on your Media Cloud host.

​
Response format

Responses use the JSON:API media type, application/vnd.api+json. A single asset is wrapped in data; lists add links and meta for pagination.
Bulk trash and bulk delete answer 204 No Content with an empty body.

​
What you can do

Upload assets

Add one file, or many with a single bulk request.

List and fetch

Page through your library or fetch one asset by id.

Trash and delete

Soft delete first, then remove permanently.

Authenticate

Send your API key as a Bearer token.

Start with the quickstart

Upload your first asset in a few minutes.