Trigger dataset file reload or reprocess
POST/datasets/:id/datareloads
Starts an asynchronous reload of selected files, or reprocess when action=reprocess. Caller must be owner or editor.
Default (omit query params): for TableUpdate=reload datasets only; Files must be pending file-load keys. Append datasets → GE-1034 ("API '/datasets/{id}/datareloads' not supported for append type datasets"). Concurrent load while DatasetStatus is reloading → "Dataset status is in reloading state, please wait for current load to finish". Empty Files → IPV-1001.
action=reprocess: for TableUpdate=append only (max 20 files); reload-type datasets → GE-1034 ("File reprocessing is only allowed for append type datasets"). More than 20 files → GE-1045 ("File reprocessing is only allowed for 20 files at a time"). Query params present without action=reprocess → IPV-1071.
Success Messages: - Reload: "Dataset reload started successfully and is running in background" + DatasetId
- Reprocess with valid files: "Files reprocessing initiated" + DatasetId
- Reprocess with no valid files: "No valid files to reprocess" (Message only; DatasetId omitted)
Request
Responses
- 200
- 400
- 500
Async reload or reprocess started (or no valid reprocess files). Messages: "Dataset reload started successfully and is running in background" (+ DatasetId); "Files reprocessing initiated" (+ DatasetId); or "No valid files to reprocess" (Message only).
Response Headers
Validation failure. GE-1034 (append vs reload mismatch, or invalid pending files), GE-1045 (>20 reprocess files), IPV-1071 (bad/missing action when query params present), IPV-1001 (empty Files), concurrent reloading Message.
Response Headers
Backend/generic failure.