imports

Start a planned import — seals the uploaded objects and queues the load (owner/admin)

Owner/admin. SEALS the upload: every object you pushed is recorded by version, and each is then server-side COPIED into a location your upload credential cannot write, from which — and only from which — the load reads. Overwriting your staged files after this point therefore cannot change what is imported. A table with nothing uploaded is a 422. This CREATES TABLES and WRITES DATA and is NOT a transaction: a failed or cancelled import leaves what it already wrote. One import runs per project at a time.

post/v1/projects/{project_id}/imports

Request

  • Base URL: https://api.wavehouse.cloud
  • URL: https://api.wavehouse.cloud/v1/projects/{project_id}/imports
  • Auth: one of:
    • API key in cookie whc_session
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

project_idstring required

Headers

Idempotency-Keystring

A unique value you choose per logical request (a random UUID). A retry with the same key and the same request within 24 hours returns the first response, marked Idempotency-Replayed: true, instead of acting twice. The same key with a different request is refused with 422; one sent while the first is still running gets 409.

Request body

job_idstring required

the job_id the plan returned. On the staging path this is the prefix you uploaded into

pathstring
plan_digeststring

the plan_digest from the plan response; when supplied the recomputed plan must match it exactly (409 if not)

Response

Accepted

attemptinteger required
bytes_doneinteger required
cancel_requestedboolean
created_atstring date-time required
finished_atstring date-time
job_idstring required
last_errorstring
max_attemptsinteger required
pathstring
query_idstring

the engine query_id of the statement most recently issued for this job

rows_doneinteger required
started_atstring date-time
statusstring required

queued | running | succeeded | failed | dead | cancelled

tablesstring[]
updated_atstring date-time required

Changes

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