sheets

Query a page of a Sheet's logical row view.

Serves one page of a sheet's logical row view: decrypted pending WAL edits merged over flushed warehouse rows (engine-mediated; dvt's server never decrypts the sealed WAL — only the engine holds the DEK — ADR-0012). Supports keyset pagination, an optional server-side text or range filter (up to 20 filter clauses), and an optional sort on 1-3 columns. POST (not GET) so filter text — which may contain data values — stays out of URLs and access logs. Requires sheet:read and a writeback connection — auto-bound at create time in the Snowflake Native App (ADR-0077 r2, DVT-2905), declared explicitly elsewhere.

post/v1/sheets/{id}/rows/query

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/v1/sheets/{id}/rows/query
  • Auth: one of:
    • API key in cookie dvt_session
    • HTTP bearer

Request body

pageSizeinteger

Number of rows to return per page. Default 100. An integer outside [1, 500] is rejected with 400.

cursorstring

Opaque keyset cursor from a prior response's nextCursor. Omit to start from the first page. A malformed cursor is rejected with 400.

Response

One page of the logical row view.

Changes

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