Get migration issues

The per-item issue log in three lists: items that failed, items intentionally skipped with the reason why, and non-blocking warnings (things the engine worked around without failing the run).

Use this to answer “which products didn’t make it, and why?”. The log is embedded into the durable snapshot before a run’s working files are reclaimed, so it stays readable for finished runs. Entries are sanitised — entity, name, status, and reason only; never request bodies or credentials.

GET /migrations/{id}/issues

Get migration issues

cURL

curl --request GET \
  --url https://app.vortexiq.ai/v2/api/bc-migration/migrations/{id}/issues \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.vortexiq.ai/v2/api/bc-migration/migrations/{id}/issues"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.vortexiq.ai/v2/api/bc-migration/migrations/{id}/issues', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.vortexiq.ai/v2/api/bc-migration/migrations/{id}/issues",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.vortexiq.ai/v2/api/bc-migration/migrations/{id}/issues"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.vortexiq.ai/v2/api/bc-migration/migrations/{id}/issues")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.vortexiq.ai/v2/api/bc-migration/migrations/{id}/issues")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

200

{
  "failures": [
    {
      "entity": "products",
      "name": "Smith Journal 13",
      "status": 422,
      "reason": "duplicate SKU SM-13 on destination"
    }
  ],
  "skipped": [
    {
      "entity": "pages",
      "name": "Legacy landing",
      "status": null,
      "reason": "page type not supported by destination theme"
    }
  ],
  "warnings": [
    {
      "entity": "images",
      "name": "#101",
      "reason": "source image returned 404 — product migrated without it"
    }
  ]
}

{
  "message": "Store Migration is not enabled for this organization."
}

{
  "error": "<string>",
  "message": "<string>",
  "status": 123,
  "errors": {}
}

Authorizations

Authorization · string · header · required

A bearer token from Login, sent as Authorization: Bearer <token>. Valid for 10 days; scoped to the user and organisation it was issued for. Rotating or disabling the organisation's API credential immediately invalidates all outstanding tokens. Browser calls from a signed-in app.vortexiq.ai page are also accepted via session cookie — see Authentication.

Path Parameters

id · string · required

The migration request id returned by Create migration.

Response

200

application/json

Failures, skipped items, and warnings.

failures · object[]

Show child attributes

skipped · object[]

Show child attributes

warnings · object[]

Non-blocking issues (for example an unrecoverable 404 source image, or a dropped filter context). They do not fail the run.

Show child attributes