Skip to main content
POST
Open a workbook import from rows sent as data and check it without writing anything to the records.

Headers

Prefer
enum<string>

Preference

Available options:
params=single-object

Body

Open a workbook import from rows sent as data and check it without writing anything to the records. p_sheets is a list of sheets, each {"sheet": "Assets", "rows": [{"Asset number": "P-101", "Name": "Pump 1", "Site": "PLANT1"}]}: a sheet is named after the list it holds, and its rows are objects of column heading and cell value. A sheet whose headings are all the fields' own labels exactly is mapped without a person, and when every sheet is, the whole workbook is checked before this returns. The result gives bundle_id and, per sheet, the rows, how many will be created and how many have problems; commit the bundle to create them.

Sheets may come in any order: they are written in dependency order, and a sheet may name a record another sheet is about to create. A sheet whose name is not a list that can be imported refuses the whole call. Nothing is created until the workbook is committed, and a committed workbook can be undone. Up to 20 sheets and 10,000 rows; larger files belong in the Import Studio.

p_file_name
string<text>
required
p_sheets
string<jsonb>
required

Response

200

OK