Skip to main content
talkvalue path import is the CLI surface of the bulk CSV import feature. The flow has four scriptable steps: upload and analyze the file, create the job with a column mapping, monitor the job until it reaches a terminal state, and export any rows the server rejected. The same pipeline backs the dashboard import wizard.

​
Subcommands

CommandDescription
import analyzeUpload a CSV and pre-check it. Returns a fileKey, headers, a preview, and the server’s guess at the column mapping.
import createStart an import job from a fileKey plus a mapping. Returns the job ID.
import getInspect a job. Use it to poll until status is COMPLETED, PARTIAL_SUCCESS, or FAILED.
import failed-exportStream rejected rows as CSV so you can fix them and re-import.

​
Typical workflow

talkvalue path import analyze --file ./registrants.csv --json
# pick the fileKey, columnMappings, and a sourceId (channel id)
talkvalue path import create \
  --file-key "u/2026/05/abc.csv" \
  --source-id 7 \
  --mode UPDATE \
  --mapping 0:EMAIL --mapping 1:FIRST_NAME --mapping 2:LAST_NAME
talkvalue path import get 4218
talkvalue path import failed-export 4218 > failed.csv
Each step is idempotent on the CLI side. Re-running analyze produces a new fileKey without touching prior imports, and get is a read. Only create writes, and the resulting job has its own ID so repeating the command queues a second import rather than overwriting the first.

​
See also