Actions15
- Dataset Actions
- Document Actions
- Record Actions
Document → Upload
AI-generatedSummary
Upload a document to a selected Klaaro dataset from an incoming binary file or a URL. Optionally set its extraction class, idempotency key, or replacement document ID; wait for processing and include extracted records in the result.
Inputs
- Dataset Name or ID (required) — Select the target dataset or provide its ID.
- Upload Source — Choose Binary File (default) or URL.
- Input Binary Field (required) — For binary uploads, name the incoming binary property containing the file; defaults to
data. - File URL (required) — For URL uploads, provide the file URL.
- Filename — For binary uploads, override the file's existing filename. If blank, the binary filename is used, falling back to
upload. - Fixed Class — Supply a class slug to force for extraction.
- Idempotency Key — Send an idempotency key with the upload request.
- Replace Document ID — Specify a document ID to replace during upload.
- Wait Until Done — Defaults to true. When enabled, poll the document until it completes, fails, or is cancelled; polling interval defaults to 3 seconds and timeout to 300 seconds.
- Include Records on Success — When waiting is enabled, fetch extracted records after successful processing; defaults to true.
- Record Format — Choose Clean (default), Flat, or Nested for the fetched records. Applies when waiting and including records.
- Polling Interval (Seconds) — Delay between status checks when waiting; defaults to 3 seconds.
- Timeout (Seconds) — Maximum time to wait for a terminal document status; defaults to 300 seconds.
Output shape
A single document object per input item, or one object for each returned item if the node processes multiple inputs.
Without waiting, returns the upload response. With waiting, returns the final document; failed or cancelled processing raises an error, and timeout also raises an error. If records are included after completion, the document object is augmented with
recordsandclassfrom the selected record format. Uses the Klaaro API credential.