Push a file

Same as PUT, always JSON. ?format= decides the parse regardless of Content-Type.

post/api/v1/push

Request

  • Base URL: https://rows.page
  • URL: https://rows.page/api/v1/push
  • Auth: one of:
    • none
    • HTTP bearer
    • API key in header X-Rows-Token

Query parameters

format'csv' | 'tsv' | 'json' | 'jsonl' | 'ndjson' | 'parquet'

Decides the parse; otherwise the file extension, then Content-Type, then content sniffing

namestring

File name, e.g. orders.csv

titlestring

Dataset title (max 200)

summarystring

What this is and what to look at (max 4000)

keystring

Upsert one named dataset per account (API key required)

id_columnstring

Column identifying a row across versions, for changed-row diffs

datasetstring

Push a new version of this dataset (needs its token or the owning account)

sourcestring

Where the data came from

runstring

Run id of the producing job

commitstring

Commit sha of the producing code

visibility'public' | 'private'

private needs Pro or Max

json'1' | 'true'

PUT only: answer with JSON instead of plain text

Response

New version, or unchanged: true when the bytes match the latest version

idstring
versioninteger
urlstring
owner_urlstring nullable

url#t=<token>; only on creation. Treat like a password.

tokenstring nullable

Dataset token; only on creation

formatstring
bytesinteger
rowsinteger nullable
rows_exactboolean
expires_atstring date-time nullable
unchangedboolean

Changes

No recorded changes to this operation across all 1 revision of this API.