Datasets
Create a dataset upload URL
Create a presigned upload URL with POST /v1/datasets/upload/url, upload the file as application/octet-stream, then process it with the returned dataset_id.
POST
Create a dataset upload URL
POST /v1/datasets/upload/url
Create a presigned upload URL for a new dataset file.
Bind the URL to the file
Optionally sendcontent_length (the exact byte count, up to 5 GiB) and
sha256 (a 64-character hexadecimal digest). Storage then rejects a PUT whose
size or digest differs, which catches truncated and corrupted uploads before
processing.
Upload the file
Upload the exact file bytes topresigned_url before it expires. Copy every
entry in the response’s upload_headers object exactly. The object always
contains Content-Type: application/octet-stream; when you declared
content_length and sha256, it also contains the signed Content-Length and
x-amz-checksum-sha256 values. A missing or changed signed header returns
403.
Content-Length from the body, but it must still
match the signed value.
After the upload succeeds, pass the returned dataset_id to
POST /v1/datasets/upload/process.
Authorization
Requires the Owner, Admin, or Editor team role. Other roles receive403 Forbidden.
