Dataset

Open a new upload session for an existing dataset

Get a fresh presigned URL to upload a new version into a dataset you already have — a corrected file, or the next chunk of history. Behaves the same way POST /datasets does for a brand-new dataset's own upload: at most one upload session is open per dataset at a time, so calling this again before finalizing just hands back that same session rather than opening a second one — safe to call repeatedly if a response gets lost.

Once a session has been finalized (successfully or not), the next call here opens a genuinely new one for that dataset's next version.

post/datasets/{datasetId}/uploads

Request

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

Path parameters

datasetIdstring required

Example:ds_3f9a1c2e7b0d4a5f

The id returned by POST /datasets

Response

An upload session — new, or the one already open for this dataset

uploadIdstring required

Identifies this upload session. Pass to POST /datasets/{datasetId}/uploads/{uploadId}/finalize once the PUT completes.

Example response

{
  "uploadId": "up_1a2b3c4d5e6f7a8b",
  "upload": {
    "url": "https://storage.qtsurfer.com/uploads/00000000-.../up_1a2b3c4d5e6f7a8b/raw.csv?X-Amz-...",
    "expiresInMinutes": 15
  }
}

Changes

No operation changes recorded.