Dataset

Finalize an uploaded file and start ingest

Changed on

Call once the file has been PUT to the upload.url from POST /datasets (or from POST /datasets/{datasetId}/uploads). Enqueues ingest and returns immediately; poll GET /datasets/{datasetId}/uploads/{uploadId} for the result.

Idempotent while the upload is still open — a repeat finalize before it has produced a version returns the same jobId rather than enqueueing a second ingest. Once it HAS produced a version, uploadId is spent: finalizing it again is a 409, even with different bytes freshly PUT to the same URL — open a new upload session instead (POST /datasets/{datasetId}/uploads) rather than reusing a spent one.

post/datasets/{datasetId}/uploads/{uploadId}/finalize

Request

  • Base URL: https://api.qtsurfer.net/v1
  • URL: https://api.qtsurfer.net/v1/datasets/{datasetId}/uploads/{uploadId}/finalize
  • Auth: HTTP bearer

Path parameters

datasetIdstring required
Example:ds_3f9a1c2e7b0d4a5f

The id returned by POST /datasets

uploadIdstring required
Example:up_1a2b3c4d5e6f7a8b

The uploadId returned by POST /datasets

Response

Ingest queued

jobIdstring required

Changes