Download status

Returns the status of a background download initiated via Upload from URL. Poll this endpoint until the status is completed or failed.

Method: GET

URL: https://example.com/<MIXPOST_CORE_PATH>/api/<workspaceUuid>/media/remote/<downloadId>/status

Authorization: Bearer <token>

Response:

200 (in progress)

{
  "status": "downloading",
  "progress": 50
}

The status field can be one of: pending, downloading, processing.

The progress field is a number from 0 to 100.

200 (completed)

{
  "status": "completed",
  "progress": 100,
  "media": {
    "id": "1",
    "uuid": "511b8c2d-c424-3a6a-a154-be271418ff01",
    "name": "video.mp4",
    "mime_type": "video/mp4",
    "type": "video",
    "url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi.mp4",
    "thumb_url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi-thumb.jpg",
    "is_video": true,
    "created_at": "2024-03-29 15:33:23"
  }
}

200 (failed)

{
  "status": "failed",
  "error": "Download timed out"
}

401

{
  "message": "Unauthenticated."
}

403

{
  "message": "Access forbidden."
}

404

{
  "status": "failed",
  "error": "Remote file download not found."
}