Skip to main content
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 send content_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 to presigned_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.
Most HTTP clients calculate 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 receive 403 Forbidden.