Quickstart

The examples use two variables: BASE_URL (your Media Cloud host) and API_KEY (your key).

export BASE_URL="https://api.mediacloud.me"
export API_KEY="your_api_key"

Upload a file

Send the file as multipart/form-data in the file field.

curl -X POST "$BASE_URL/api/v1/assets" \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@./photo.jpg"

const form = new FormData();
form.append("file", fileInput.files[0]);

const res = await fetch(`${BASE_URL}/api/v1/assets`, {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}` },
  body: form,
});
const { data } = await res.json();

The response is 201 Created with the new asset. Keep its id.

Fetch it back

curl "$BASE_URL/api/v1/assets/ASSET_ID" \
  -H "Authorization: Bearer $API_KEY"

Use attributes.url to display the file, or attributes.download_url to download it.

List your assets

curl "$BASE_URL/api/v1/assets?page=1" \
  -H "Authorization: Bearer $API_KEY"

Trash, then delete

curl -X POST "$BASE_URL/api/v1/assets/bulk-trash" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_ids": ["ASSET_ID"]}'

Both bulk routes answer 204 No Content. To remove the asset for good, call Bulk delete assets.

Uploaded assets return is_favourite: null. Fetch or list them to see the stored value.

Get started

Core concepts

Reference