Dataset

Complete a file upload and trigger processing

File uploads only. Call after uploading bytes to the presigned URL from POST /datasets. Verifies the file exists in S3, then triggers the preprocessing pipeline. TXT files are converted to rows here. Documents (pdf, docx, pptx, xlsx, html, or a zip holding them) are not: the dataset then reports awaiting_input until POST /datasets/{dataset_id}/launch-preprocessing extracts them.

post/api/v1/datasets/{dataset_id}/upload/complete

Request

Path parameters

dataset_idstring required

Request body

file_size_bytesnumber required

Size of the uploaded file in bytes (for verification)

sha256string

SHA-256 hex digest of the uploaded file (for integrity verification)

Example request

{
  "file_size_bytes": 1048576,
  "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
}

Response

dataset_idstring required

ID of the dataset

statusstring required

Current status of the dataset after completing upload

Example response

{
  "dataset_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing"
}

Changes

No recorded changes to this operation across all 10 revisions of this API.