cURL
Post apidatasets versions preprocess
POST /datasets//versions//preprocess — enqueue a preprocessing job.
Allowed source states: UPLOADED, PREPROCESSING_FAILED. Anything else returns 409. On success, returns 202 with the queued job; poll the version status endpoint to follow the QUEUED → RUNNING → SUCCEEDED|FAILED transitions.
POST
cURL
Body
POST /datasets/.../preprocess — open-shape preprocessing parameters.
The schema of parameters is open-shape JSON: each preprocessing
module owns and validates the shape of its own parameters.
Two layered size caps apply; requests exceeding either cap are rejected with 400:
PARAMETERS_MAX_BYTEScaps the encoded JSON ofparametersas a whole — a guard against runaway payloads.MAX_RAW_TEXT_BYTEScaps theraw_textcarrier specifically. The tabular module reads file contents fromparameters['raw_text'], so this cap applies at much larger sizes than the general parameters cap. Tunable via theDATAERAI_MAX_RAW_TEXT_BYTESenv var for self-hosted deployments (e.g. to let dev fixtures override the default).
Response
202 - application/json
QUEUED- QueuedRUNNING- RunningSUCCEEDED- SucceededFAILED- FailedCANCELLED- Cancelled
Available options:
QUEUED, RUNNING, SUCCEEDED, FAILED, CANCELLED