Skip to Content

Media States and Actions

What each media state means, and what delete and upload pause actually do.

Every video and image has one state at a time. This page explains each state and what you can do while an item is in it.


States

StateAPI statusMeaning
UploadingFILE_STATUS_UPLOADINGWaiting for the binary payload to arrive at the storage endpoint.
UploadedFILE_STATUS_UPLOADEDFile received in storage; awaiting ingestion and processing.
ProcessingFILE_STATUS_PROCESSINGMedia transcoding, optimization, and packaging in progress.
ReadyFILE_STATUS_READYProcessing complete; media is published and ready for delivery.
FailedFILE_STATUS_ERRORAn error occurred during upload, ingestion, or transcoding.
DeletedNoneThe item is removed from the dashboard and API (returns 404).

Stopping a Transfer

Pausing an upload only affects the client-side binary transfer:

  • The asset stays in FILE_STATUS_UPLOADING until the transfer resumes or the upload link expires.
  • If the binary transfer completed before pausing, processing proceeds automatically.
  • To cancel an unneeded upload, delete the media asset from the dashboard or API.

Media Deletion

When an asset is deleted, it is immediately removed from your project library, and the API returns a 404 response.

Asset State at DeletionProcessing StatusAvailability
UploadedIngest canceledNot published
ProcessingProcessing terminatedNot published
Ready or FailedRemovedRemoved from dashboard and API

Storage quota updates may take a few moments to reflect recently deleted assets.


Failed Items

If an asset encounters an error during processing:

  • Check the asset details in the dashboard for failure indicators.
  • Re-upload the source file or contact support if errors persist.