Authentication
This endpoint requires API key authentication only.Asynchronous Processing
This endpoint initiates an asynchronous job to process the uploaded file. The actual dataset version creation happens in the background. A draft dataset (version_number = -1) is created immediately, and upon successful processing, it’s assigned a proper version number.Webhooks
The following webhooks are triggered during the process:dataset_version_created_by_file
- Sent when the dataset version is successfully createddataset_version_created_by_file_failed
- Sent if the dataset creation fails
Notes
- Maximum file size: 100MB
- Failed drafts are automatically cleaned up
Headers
API key for authentication. This endpoint supports API key authentication only.
Body
application/json
ID of the dataset group where the new version will be created
Required range:
x >= 1
Name of the file being uploaded (must end with .csv or .json)
Required string length:
1 - 255
Base64 encoded content of the file. Maximum file size: 100MB. Supported formats: CSV, JSON
Minimum length:
1