Skip to main content
POST
Post Dataset

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required

Any label, e.g. Accounts (billing).

Required string length: 1 - 128
columns
DatasetColumn · object[]
required
Minimum array length: 1
description
string
default:""

What the table holds, shown in Rippit.

Maximum string length: 2000
pkey_cols
string[]

Columns that identify a row; re-uploads replace matching rows.

append_only_dataset
boolean
default:false

Required when pkey_cols is empty: every uploaded row is kept.

updated_at_col
string | null
mode
enum<string>
default:ongoing

adhoc = one-off dump, ongoing = cron upserts.

Available options:
adhoc,
ongoing

Response

Successful Response

dataset_id
integer
required
status
enum<string>
required
Available options:
created,
exists