List import errors

Request

List import errors. These are failed pending imports that have encountered errors during processing.

Security

ApiKey(Required scopes: data.imports.pending.list)

Query

deviceNamestring

Name of device associated with the import error

filenameMatchesstring

Pattern to match against filename

errorstring

A string to filter based on error messages

siteBackfillJobIdstring

Filter to import errors offloaded from pending imports enqueued by this site backfill job (sbj_…).

projectIdstring

Filter import errors by project

sortBystring

Sort by a single field

Enum:"createdAt""deviceName""error""requestId""updatedAt"

sortOrderstring

Sort order for the sortBy field

Enum:"asc""desc"

limitnumber, [ 0 .. 2000 ]

Maximum number of items to return

Default:2000

offsetinteger, >= 0

Number of items to skip before returning the results

Default:0

Payload

// No request payload

Responses

Success

Bodyapplication/json

Array [

createdAtstring, (date-time)required

When the pending import was created

deviceIdstring

ID of device

deviceNamestring

Name of the device from which the import originated

errorstring

Error message, if status is "error"

filenamestringrequired

Filename of the import

importIdstring

ID of import; undefined until status is "complete"

orgIdstringrequired

ID of org to which the import belongs

pipelineStagestringrequired

stage in the import pipeline the import currently occupies

requestIdstringrequired

ID of the import request

projectIdstring

ID of the project to which the import belongs

siteIdstringrequired

ID of Primary Site where import will be stored

statusstring

Status of initiated import

Enum:"received""processing""ready for indexing""error""complete"

updatedAtstring, (date-time)required

When the pending import was last updated

quarantinedAtstring, (date-time)

When the pending import was quarantined

]

Response

[
  {
    "createdAt": "2019-08-24T14:15:22Z",
    "deviceId": "string",
    "deviceName": "string",
    "error": "string",
    "filename": "string",
    "importId": "string",
    "orgId": "string",
    "pipelineStage": "string",
    "requestId": "string",
    "projectId": "string",
    "siteId": "string",
    "status": "received",
    "updatedAt": "2019-08-24T14:15:22Z",
    "quarantinedAt": "2019-08-24T14:15:22Z"
  }
]