Sign in
Planning Table

Start an import for a connected planning table

Enqueue a background import that pulls the latest source data into this table. Returns 409 with code TABLE_IMPORT_IN_PROGRESS when an import is already running. Failed imports expose error_code (e.g. SOURCE_UNAVAILABLE, IMPORT_FAILED, IMPORT_STALE).

post/tables/{table_pk}/imports

Path parameters

table_pkstring required

Headers

X-Company-IDstring required

Associates request with company

Request body

idinteger required
planning_table_idinteger required
status'ERROR' | 'IMPORTED' | 'PROCESSING' | 'CANCELLED' required
  • ERROR - Error
  • IMPORTED - Imported
  • PROCESSING - Processing
  • CANCELLED - Cancelled
status_messagestring nullable required
error_codestring nullable required
created_atstring date-time required
completed_atstring date-time nullable required
source_import_type'USER' | 'SCHEDULED' required
  • USER - User
  • SCHEDULED - Scheduled

Response

idinteger required
planning_table_idinteger required
status'ERROR' | 'IMPORTED' | 'PROCESSING' | 'CANCELLED' required
  • ERROR - Error
  • IMPORTED - Imported
  • PROCESSING - Processing
  • CANCELLED - Cancelled
status_messagestring nullable required
error_codestring nullable required
created_atstring date-time required
completed_atstring date-time nullable required
source_import_type'USER' | 'SCHEDULED' required
  • USER - User
  • SCHEDULED - Scheduled

Changes