Dataset

Initiate a batch upload

Changed on

Initiate a batch upload. A batch must be homogeneous: either all document formats (pdf, docx, pptx, xlsx, html, zip) or all tabular formats (csv, json, jsonl, parquet). Mixed batches are rejected. TXT files are permissive and may be included in either kind of batch (or alone, in which case the dataset is tabular); their contents are converted during complete-batch.

post/api/v1/datasets/upload/initiate-batch

Request

Request body

namestring required

Human-readable name for the dataset

Example request

{
  "name": "my-document-dataset",
  "files": [
    {
      "file_name": "report.pdf",
      "file_format": "pdf",
      "file_size_bytes": 1048576
    }
  ]
}

Response

dataset_idstring required

Dataset ID

Changes