Datasets

Get an upload URL for dataset data

Returns a presigned S3 PUT URL. Step one of the two-step upload: PUT your CSV or parquet bytes to the returned url with Content-Type set to exactly the file_type you requested (a mismatch makes S3 reject the signature), then call POST /dataset/{dataset_id}/mutation with the URL stripped of its query string to fold the upload into the dataset.

The upload lands at a unique per-file key, so an upload alone never overwrites the current data.

post/dataset/{dataset_id}/presigned_url

Request

  • Base URL: https://api.indexone.io
  • URL: https://api.indexone.io/dataset/{dataset_id}/presigned_url
  • Auth: API key in header x-api-key and API key in header Authorization

Path parameters

dataset_idstring required

Dataset id.

Request body

file_typestring required

MIME type of the upload; becomes the required Content-Type of the PUT.

file_namestring

Optional filename. Defaults to a generated fil_... name.

Example request

{
  "file_type": "text/csv"
}

Response

The presigned upload URL.

urlstring uri

Presigned PUT URL.

keystring
bucketstring
dataset_idstring
content_typestring

Changes

No recorded changes to this operation across all 1 revision of this API.