Create product media import job

Queues a background import job that downloads remote media and attaches it to products by SKU.

POST/api/unstable/imports/product-media/jobs

Queues a background import job that downloads remote media and attaches it to products by SKU.

Request Body

application/json

rows*array<>

Rows to import into product media.

mediaType?string

Target media slot type to create for each row.

Value in"image" | "document"

Example"image"

onlyIfMissing?boolean

When true, skip products that already have media of the selected type.

Exampletrue

concurrency?integer

Optional concurrent download/upload worker count.

Range1 <= value <= 50

Example10

timeoutMs?integer

Optional per-download timeout in milliseconds.

Range1000 <= value <= 60000

Example15000

[key: string]?never

Response Body

`application/json`

curl -X POST "https://loading/api/unstable/imports/product-media/jobs" \  -H "Content-Type: application/json" \  -d '{    "rows": [      {        "sku": "SKU-123",        "url": "https://example.com/media/image-1.jpg"      }    ]  }'

{
  "jobId": "job_123"
}

{
  "issues": [
    {
      "_tag": "Pointer",
      "path": [
        "string"
      ],
      "message": "string"
    }
  ],
  "message": "string",
  "_tag": "HttpApiDecodeError"
}

Empty

{
  "message": "string",
  "_tag": "ApiForbiddenError"
}

{
  "message": "string",
  "_tag": "ApiNotFoundError"
}

{
  "message": "string",
  "_tag": "ApiConflictError"
}

{
  "message": "string",
  "_tag": "ApiUnprocessableEntityError"
}

Empty

{
  "message": "string",
  "_tag": "ApiTimeoutError"
}

Create product media import job

Request Body

Response Body

200application/json

400application/json

401

403application/json

404application/json

409application/json

422application/json

503

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`