List Viz Subscriptions

GET 
/v1/viz/:viz_id/subscriptions

This viz's subscriptions, one cursor page at a time.

nextKey is emitted ONLY when a further page genuinely exists — the SQL layer fetches limit + 1 and lets the probe row decide. It used to be the id of the last row on every non-empty page, so a one-row list said nextKey: 1 and sent every cursor-honouring caller after a page that was not there. A drain-until-empty caller never sees an error for that, only one extra fetch per list, so it is found by reading the envelope rather than by a failure. hasMore is derived from nextKey by PageEnvelope, and total is counted, so a caller can assert len(subscriptions) == total rather than trusting the drain.

Cursor-paginated. The wire query parameter is exclusiveStartKey (what the cURL tab and the parameter table show); the TypeScript SDK takes it as the exclusiveStartKey option and the Python SDK as the exclusive_start_key keyword — one parameter, spelled per language. Pass the previous page's nextKey and stop when it comes back null — or let iterAll() / iter_all() drive the cursor for you (see the SDKs page, "Pagination").

Request

Responses

200

Successful Response

404

Not found

422

Validation Error