table-imports

Re-read a pending upload from a different sheet

Read the workbook that was already uploaded from another of its sheets, and return a fresh preview. The upload is not sent again: the file is already stored, and it can be large.

Every column is inferred from scratch, so the mapping in the response REPLACES the one being edited rather than merging into it. Two sheets share nothing but a file.

Only a pending import can change sheet; once committed, the table exists and its columns are fixed.

post/table-imports/{import_id}/sheet/

Request

  • Base URL: https://api.getoneprofile.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.getoneprofile.ai/table-imports/{import_id}/sheet/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

import_idstring uuid required

Request body

sheetstring required

A sheet name from the preview's sheet_names.

Response

Successful Response

estimated_row_countinteger required

Data rows in the file, excluding the header.

import_idstring uuid required

Identifies this upload through commit and polling.

importable_row_countinteger required

How many of those rows the import will write, once the cap is applied.

row_limitinteger required

Rows one table may hold on this organisation's plan.

selected_sheetstring nullable

Which sheet these columns were read from. Null for a CSV. POST it to the sheet endpoint to re-read the same upload from a different one.

sheet_namesstring[]

Every sheet the uploaded workbook offers, in tab order. Empty for a CSV, which has no sheets. That is what says not to offer a sheet picker.

warningsstring[] required

Non-fatal things the user should see.

Changes

No recorded changes to this operation across all 1 revision of this API.