talkvalue path import

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

Command	Description
`import analyze`	Upload a CSV and pre-check it. Returns a `fileKey`, headers, a preview, and the server’s guess at the column mapping.
`import create`	Start an import job from a `fileKey` plus a mapping. Returns the job ID.
`import get`	Inspect a job. Use it to poll until `status` is `COMPLETED`, `PARTIAL_SUCCESS`, or `FAILED`.
`import failed-export`	Stream 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.

Get Started

Global

Commands

Recipes

AI Agents

Reference

Subcommands

Typical workflow

See also

​Subcommands

​Typical workflow

​See also

Subcommands

Typical workflow

See also