Skip to main content
POST
Preview a CSV batch import

Authorizations

rial_session
string
cookie
required

Dashboard / operator session cookie. Set by /v1/auth/google/callback after Google OAuth, JWT signed with the rotating rial-platform/session-signing HMAC. Read on every request the SPA makes with credentials: include. Browser-only — server-to-server callers use bearerApiKey instead.

Path Parameters

slug
string
required

Template slug — lowercase [a-z0-9-].

Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
Example:

"warehouse-intake"

Body

application/json
csv
string
required

Raw CSV text, header row first.

Minimum string length: 1
column_mapping
object

Optional explicit header→field mapping when automap falls short.

Response

Parse report — resolved mapping, valid/invalid rows, abort prediction.

column_mapping
object
required
ignored_columns
string[]
required
total_rows
integer
required
valid_rows
integer
required
invalid_rows
object[]
required
invalid_rows_total
integer
required
would_abort
boolean
required
preview
object[]
required