v4

latestOpenAPI 3.1.02026-08-01207318738.7 KB

Uploads

Replace an upload's data

Replace the data behind an existing CSV upload while keeping its id stable. The new file lands as fresh storage and (when the connection stages uploads) a fresh warehouse table, and the upload's pointers move to them — views and document tabs reference the upload by id, so they serve the new data with no model or document changes. Column renames/removals may break content referencing the old columns.

put/api/v1/uploads/{uploadId}

Path parameters

uploadIdstring uuid required

ID of the upload to delete

Response

Upload data replaced successfully

fileNamestring required

File name of the replacement upload

idstring uuid required

The upload id — unchanged by the data swap

inDbAsTableNamestring required

Database table name in the scratch schema (empty for S3-only connections)

refreshedModelIdsstring[] required

Models whose view of this upload was re-pointed at the new data (the upload's workbook model, or the connection's shared models holding a view backed by this upload)

rowCountinteger required

Number of rows in the replacement file

truncatedboolean required

Whether the file was truncated due to row limit

viewNamestring required

View name — unchanged by the data swap

Example response

{
  "fileName": "users_updated.csv"
}