Listing import errors

After an import or synchronization job completes, you can get a list of the errors that occurred by using the Import Results resource: GET /import/results/{jobId}/errors. The id of the job is returned in the Import API request response body as the id field.

You can see if there are any errors by retrieving an import summary or by getting the job state and job result from the Jobs resource of the REST Core API: GET /jobs/{jobId}.

Parameters

Parameter Parameter type Description
jobId (required)

String (UUID)

The universally unique identifier (UUID) of the job.
offset

Integer

The first result to retrieve. If not set or set to 0, results will be retrieved starting from row 0.

The default value is 0.

limit

Integer

The maximum number of results to retrieve. If not set or set to 0, the default limit of 1000 will be used.

The default value is 0.

countLimit

Integer

Allows to limit the number of elements that will be counted. -1 counts everything and 0 causes the count to be skipped.

The default value is -1.

Response example

{
  "total": 1000,
  "offset": 10,
  "limit": 100,
  "results": [
    {
      "errorType": "RUNTIME",
      "resourceType": "ASSET",
      "errorMessage": "error message",
      "command": {
        "indices": [
          1,
          2,
          3
        ],
        "identifier": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
      }	
    }
  ]
}