A valid request URL is required to generate request examples{
"__typename": "MediaImage",
"id": "<string>",
"fileStatus": "<string>",
"fileErrors": [
{
"code": "<string>",
"details": "<string>",
"message": "<string>"
}
],
"mediaContentType": "<string>",
"alt": "<string>",
"image": {
"altText": "<string>",
"height": 123,
"id": "<string>",
"url": "<string>",
"width": 123
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Copy an image or video from a public URL into the merchant's Shopify Files
Downloads url and uploads it to Shopify Files like /upload does (same waiting, same multi-store fan-out and side effects), returning the processed file node. Used to import Instagram media into a content block. A source that answers 4xx (e.g. an expired Instagram CDN link) is a 400; the source must send a Content-Length.
A valid request URL is required to generate request examples{
"__typename": "MediaImage",
"id": "<string>",
"fileStatus": "<string>",
"fileErrors": [
{
"code": "<string>",
"details": "<string>",
"message": "<string>"
}
],
"mediaContentType": "<string>",
"alt": "<string>",
"image": {
"altText": "<string>",
"height": 123,
"id": "<string>",
"url": "<string>",
"width": 123
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Authorizations
Shopify App Bridge session token of the embedded Depict: Search & Merchandising app. The shop in the token determines the merchant; merchant_id parameters must belong to that shop.
Path Parameters
Lite merchant id of the store to upload to, e.g. shopify-<shop id>.
Query Parameters
The collection being edited. In a multi-store group, the file is also uploaded to every store whose collection is linked to this one; omit it to upload to this store only.
Alt text stored on the Shopify file.
Public http(s) URL of the media to copy.
Uploaded as image/jpeg or video/mp4 respectively.
image, video Response
The file as Shopify holds it once processed (this store's copy): a MediaImage or a Video.
- Option 1
- Option 2
MediaImage Shopify MediaImage GID; store it to reference the file.
Shopify's file status: always READY on a 200 (the route waits out processing; a failed file answers 400).
Show child attributes
Show child attributes
IMAGE.
Show child attributes
Show child attributes
Was this page helpful?