Skip to main content
GET
One page of a dataset's records, optionally through a saved view

Authorizations

hookie_session
string
cookie
required

The console's sealed session cookie, set by WorkOS AuthKit. Mutating requests also require the X-Requested-With CSRF header.

Path Parameters

pid
string
required

Project id (UUID) belonging to the caller workspace.

dataset
string
required

Dataset name.

Query Parameters

view
string

Record-view id to shape and sort the rows. The view must belong to this webhook.

limit
integer
default:25

Rows per page (default 25, max 1000).

Required range: 1 <= x <= 1000
offset
integer
default:0

Rows to skip (default 0).

Required range: x >= 0

Response

One page of the dataset's records, newest first unless the view sorts otherwise. Without a view, every row is the record meta columns plus its whole flattened payload and columns is the discovered key set. With a view, each row carries _id plus exactly the view columns (missing keys become null), sorted in SQL by the view sort key. available_columns is always the full discovered set; total is the dataset's whole record count.

dataset
string
required
view
object | null
required

The applied view in list shape (snake_case), or null.

columns
object[]
required
available_columns
string[]
required

Includes the meta columns _id, _received_at and _source.

rows
object[]
required
count
integer
required
total
integer
required
limit
integer
required
offset
integer
required