Download status
GET/:workspace/media/remote/:downloadId/status
Polls a queued remote download. Progress is tracked for up to 1 hour, after which the record expires.
A terminal result is readable only once: as soon as a poll observes completed or failed, the record is discarded, and any subsequent poll for the same download_id returns 404. Make sure you keep the media from the response you receive.
Downloads are scoped to the workspace that started them; a download_id belonging to another workspace is reported as not found.
Request
Responses
- 200
- 401
- 403
- 404
Current download state.
The bearer token is missing, malformed, unknown, or expired.
The token is valid, but the user it belongs to may not perform this action:
- they are not a member of the
{workspace}in the path; or - their workspace role is too low for this endpoint (write routes require Admin or Member); or
- for
/panelendpoints, they are not a platform administrator.
The host application that Mixpost is installed into can also deny access to Mixpost as a whole, which produces the same response.
The workspace was not found, or the download record does not exist, has already been read, has expired, or belongs to another workspace. Note that the two cases return different body shapes: a missing workspace returns a message, while a missing download record returns status: failed with an error.