importJobs
Módulo Platform · 5 operaciones
List import job rows
GET/import-jobs
A spreadsheet import through detect, map, validate, deduplicate, dry run and commit. Returns a cursor page of import job rows the caller may see. The default order is `created_at` ascending. Supports sparse fieldsets and the filter grammar.
Create an import job
POST/import-jobs
A spreadsheet import through detect, map, validate, deduplicate, dry run and commit. Creates an import job. Requires `Idempotency-Key`; a replay returns the original response. The organization is derived from the credential or the parent row, never from the body.
Get an import job
GET/import-jobs/{id}
A spreadsheet import through detect, map, validate, deduplicate, dry run and commit. Returns one import job with its `ETag`. A import job the caller may not see returns 404.
Dry-run an import
POST/import-jobs/{id}/dry-run
Counts what committing a validated import would write (app.import_dry_run): creates, strong key updates, merges a person chose, refusals and possible duplicates still pending. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.
Commit an import
POST/import-jobs/{id}/commit
Writes the validated rows in one import batch. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.