Retry failed rows

POST https://api.invunion.com/api/v1/import-jobs/:id/retry-failed ingest:write Idempotency-Key Markdown

Re-queue only the failed rows of an import job.

Puts the failed rows of the job back in the queue and answers 202. Rows that were created, skipped, or duplicates are not touched. retried is the number of rows queued again; when it is 0, status is unchanged. Fix the cause first (for example create the missing counterparty), since the rows are retried with the same data. Needs the same scopes as creating the job.

See also

  • Get import job (GET/api/v1/import-jobs/:id). Read the failed rows before retrying.

Path parameters

NameTypeRequired
id

Import job UUID, from Create import job or List import jobs.

Example: 6a4deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d

string

No maximum

Required

Errors

This operation can return the following errors in addition to generic HTTP failures.

Error HTTP code Description
Missing Bearer token 401 The Authorization header is missing or is not a Bearer token.
Invalid or revoked API key 401 The API key is unknown, malformed, expired, or has been revoked.
API key is missing scope ingest:write 403 The key does not include ingest:write. A write scope does not imply the matching read scope.
Too many requests, please try again later 429 More than 100 requests in one minute from this API key or IP address. Wait for the Retry-After header (seconds) and retry.
API key is missing scope … 403 Besides ingest:write, the key needs the write scope of the entity: ingest:write for transactions, invoices:write, counterparties:write, or payment_methods:write. code is missing_scope.
Invalid job id 400 The path is not a UUID.
Import job not found 404 No import job with this UUID exists in the authenticated tenant.
Internal server error 500 Unexpected server error. The JSON body includes correlationId. Retry with backoff.
Idempotency-Key must be 8-255 characters: letters, digits, ".", "_", ":" or "-". 400 The Idempotency-Key header is present but malformed.
A request with this Idempotency-Key is still being processed. 409 The first request with this key has not finished. Retry after it completes. code is idempotency_in_progress.
This Idempotency-Key was already used with a different request body. 422 Send a new key for a different request. code is idempotency_key_reuse.
Previous: Create import job Next: Overview