Start a dataset file upload
Send filename, declaredSizeBytes, and an optional format and field mapping. Files may be up to 1 GiB. Returns an upload and uploadUrl. PUT the file bytes to that URL with the required x-ms-blob-type: BlockBlob header. After the PUT succeeds, finalize the upload. The file must not exceed its declared size.
Authorizations
Enter ApiKey <your-api-key> in Authorization, including the ApiKey prefix. In cURL and Python samples, <api-key> means this full value. The TypeScript SDK adds the prefix for you.
Path Parameters
Dataset ID with prefix ds..
^ds\.[0-9a-f]{8}-[0-9a-f]{4}-[7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$Body
Declared maximum upload size in bytes, from 1 byte to 1 GiB.
x <= 1073741824Name of the file being uploaded.
1Additional fields to create from matching keys in uploaded rows. Each complete row is also stored in "uploaded"; existing profile mappings still apply.
File format: "json" (a JSON array of row objects), "jsonl" (one JSON object per line) or "csv" (a header row naming the fields, one row per item; all values are ingested as strings). Defaults to "json".
json, csv, jsonl