push
Publish rows as a rows.page dataset (or a new version of one) and get a shareable URL. Pass exactly one of csv, tsv, jsonl, json, rows or url. Up to 16 MB inline; use url for bigger files. Identical content returns unchanged: true without a new version. Re-pushes report rows_delta, columns_added/removed and a diff_url. Anonymous datasets expire after 7 days unless kept. Finding views use the rows.page query language in q: word or "two words" searches text columns; field:value, field:"a b", -field:value, field:* (not null), -field:* (null), field:foo* (prefix); field:>20, >=, <, <=, field:10..20, ISO dates (at:>2026-09-01); dot paths for nested JSON (payload.customer.country:NL); tags:urgent means the list contains it; combine with OR and parentheses. A q starting with SELECT, WITH or FROM runs as SQL against the table data. sort is comma-separated columns, - for descending (-price,name); cols picks and orders visible columns (a,b,c).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| csv | No | CSV text with a header row | |
| key | No | Stable name for upserts with an API key, e.g. nightly-orders | |
| run | No | Run id of the job that produced it | |
| tsv | No | TSV text with a header row | |
| url | No | http(s) URL of a CSV, TSV, JSON, JSONL or Parquet file to fetch and publish | |
| json | No | A JSON array of objects (or an object holding one), as text or as a value | |
| name | No | File name, e.g. orders.csv | |
| rows | No | Rows as an array of objects | |
| jsonl | No | One JSON object per line | |
| title | No | Dataset title shown on the page | |
| token | No | Dataset token (rpt_...) proving ownership of dataset | |
| commit | No | Commit sha of the code that produced it | |
| format | No | Format of url when it cannot be told | |
| source | No | Where the data came from (URL or description) | |
| dataset | No | Existing dataset id to push a new version to | |
| summary | No | A few sentences for the human: what this is and what to look at | |
| findings | No | ||
| id_column | No | Column that identifies a row across versions, for changed-row diffs | |
| visibility | No | private needs Pro or Max |