app.import_jobs
TableRow level security on
One run of the import wizard (Section 4.6.2): the uploaded file, its target, the confirmed column map and its progress.
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | No | Owning org. A row never moves to another org.References app.organizations.id |
| target_code | text | No | Target entity the rows are written to.References private.import_targets.code |
| source | app.import_source | No | CSV, XLSX or a Google Sheets link. XLS remains only on jobs created before 1241; a new .xls import is refused. |
| original_filename | text | No | File name as uploaded. |
| storage_object_path | text | No | Object path of the uploaded file in the tenant import bucket. |
| import_mapping_profile_id | uuid | Yes | Saved profile the map started from, if any.References app.import_mapping_profiles.id |
| import_status | app.import_status | No | Wizard progress. |
| mapping_confirmed_at | timestamp with time zone | Yes | When the person confirmed every column mapping; nothing is validated before it. |
| created_at | timestamp with time zone | No | When the row was inserted. Set by the database. |
| created_by | uuid | Yes | Person who inserted the row, or null for a platform process. Set by the database.References app.people.id |
| updated_at | timestamp with time zone | No | When the row last changed. Set by the database. |
| updated_by | uuid | Yes | Person who last changed the row, or null for a platform process. Set by the database.References app.people.id |
| deleted_at | timestamp with time zone | Yes | Soft delete time. A row with deleted_at set is ignored by every access helper. |
| sheet_name | text | Yes | Sheet of the workbook this import reads. NULL until detection picks the first sheet with data; set when the import was started from a detected sheet. |
| source_url | text | Yes | The Google Sheets link the import reads through the org's Google Drive connection; NULL for an uploaded file. |
| failure_code | text | Yes | Why the worker failed the import before reading it, for example google_sheet_not_shared; NULL otherwise. |
| import_job_sheet_id | uuid | Yes | Detected sheet (app.import_job_sheets) this import was started from, or NULL for an import started from an upload or a link.References app.import_job_sheets.id |