Initiate remote upload
POST/:workspaceUuid/media/remote/initiate
Download a file from a remote URL into the media library.
A file under 10 MB (or one whose server does not send its size) is downloaded during the request:
the response has status: completed and the media object, or status: failed and an error.
A larger file downloads in the background: the response has status: pending and a download_id;
poll getRemoteUploadStatus with it until status is completed or failed.
Request
Responses
- 200
- 401
- 403
- 422
The imported media, the download failure, or a background download to poll
Missing or invalid API token.
Access denied. Returned when the caller is not a member of the workspace, lacks the role
the endpoint needs, or the workspace's plan does not include API access (capability api).
Validation failed.