# Media Cloud API

> API for uploading, listing, retrieving and deleting media assets on Media Cloud.

- [Introduction](https://docs.mediacloud.me/introduction.md): Upload, organize and serve media files with a single REST API.
- [Quickstart](https://docs.mediacloud.me/quickstart.md): Upload an asset, fetch it back, then clean up.
- [Authentication](https://docs.mediacloud.me/authentication.md): Authenticate every request with your API key.
- [Assets](https://docs.mediacloud.me/concepts/assets.md): What an asset is, and what each attribute means.
- [Uploading and deleting](https://docs.mediacloud.me/concepts/upload-and-delete.md): Single and bulk uploads, and the two-step trash and delete flow.
- [Errors](https://docs.mediacloud.me/essentials/errors.md): HTTP status codes you can expect from the Media Cloud API.
- [Pagination](https://docs.mediacloud.me/essentials/pagination.md): How Get all assets paginates results.
- [Assets overview](https://docs.mediacloud.me/api-reference/assets/overview.md): Upload, list, fetch, trash and permanently delete media assets.
- [Upload asset](https://docs.mediacloud.me/api-reference/assets/upload-asset.md): Uploads a single file. Send the request as `multipart/form-data` with the file in the `file` field. To upload several files at once, use [Bulk upload assets](/api-reference/assets/bulk-upload-assets).
- [Bulk upload assets](https://docs.mediacloud.me/api-reference/assets/bulk-upload-assets.md): Uploads several files in one request. Send `multipart/form-data` and repeat the `files[]` field once per file. The response lists the created assets.
- [Get all assets](https://docs.mediacloud.me/api-reference/assets/get-all-assets.md): Returns a paginated list of assets. Each page holds 24 assets by default; follow `links.next` or pass `page` to move through the results.
- [Get asset](https://docs.mediacloud.me/api-reference/assets/get-asset.md): Returns a single asset by its `id`.
- [Bulk trash assets](https://docs.mediacloud.me/api-reference/assets/bulk-trash-assets.md): Moves several assets to the trash in one request. Trashing is the soft-delete step; to remove assets for good, use [Bulk delete assets](/api-reference/assets/bulk-delete-assets).
- [Bulk delete assets](https://docs.mediacloud.me/api-reference/assets/bulk-delete-assets.md): Permanently deletes several assets in one request. This cannot be undone.
- [Changelog](https://docs.mediacloud.me/changelog.md): New features, improvements, and fixes to the Media Cloud API.

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.