Sign in

v1

latestSwagger 2.0Apache 2.02026-07-1725956.5 KB
Data Import

Upload CSV file

Upload CSV or ZIP file and create/update table definition. This is the first step in the import workflow; use /import to process data into the database.

Direct upload: multipart/form-data with field file (small files).

Large / resumable upload:

  1. POST /api/uploads/init with filename, total_size, total_chunks, chunk_size
  2. POST /api/uploads/chunk/{upload_id} for each chunk (resume via GET /api/uploads/status/{upload_id})
  3. POST /tables/upload/{dbId}/{tableId} with JSON body { "upload_id": "<uuid>" }

Provide either file or upload_id, not both. For ZIP files, the CSV must match the ZIP filename (e.g. data.zip → data.csv).

post/tables/upload/{dbId}/{tableId}

Path parameters

dbIdstring required

Database ID

tableIdstring required

Table ID

Response

successful operation

statusstring
file_pathstring

Partial file path for import

upload_source'file' | 'upload_id'

Whether the file came from direct multipart upload or resumable upload_id

action'created' | 'updated'
csv_uploaded_atstring date-time
import_statusstring
messagestring

Example response

{
  "status": "success",
  "import_status": "ready"
}