Upload deferred migration data

POST https://app.speybooks.com/api/v1/migrations/{id}/upload-deferred

Process deferred invoice and bill sheets that were stored during the provider upload. Called by the frontend after the opening balance import is confirmed.

Reads base64-encoded CSV buffers from mapping_data.deferredSheets, calls the ODCE service for each, attaches the resulting import IDs, and clears the deferred data.

Returns a no-op success if no deferred sheets exist.

Path parameters

id string required
Migration ID (e.g. mig_1).

Response

200 Deferred sheets processed. Returns per-entity upload results and any errors. Returns success with message if no deferred sheets exist.
Show response fields
balancesImportId string
billsImportId string nullable
completedAt string nullable
contactsImportId string
createdAt string date-time
cutoverDate string
id string
invoicesImportId string
provider string
providerLabel string
reconciliation string nullable
status string
uploads object
Show child attributes
bills string nullable
invoices object
Show child attributes
importId string
status string
warnings array<object>

Error codes

400 Invalid migration ID format.
404 Migration not found.
422 Migration is in a terminal state.