pagehive

list_values

List values on this account, including read_access and site_id: the site that owns the value, or null for an account value that every site reads.

ValuesRead-onlyAll plans

What it does

List values on this account, including read_access and site_id: the site that owns the value, or null for an account value that every site reads. A secret value is listed with value: null and value_hidden: true; read it with get_value. read_access: public = pages, page scripts (bp.value) and GET /data/_values can read it. private (default) = pages can print it ({{ values.key }}) when the site owns it or has a share, but scripts and the public JSON can't. secret = for tokens, API keys and passwords: stored encrypted, never on a page, in a script, in the public JSON or in a site template; a page that uses it is refused at save; only get_value returns the content, and list_values shows the key only.

Plans

Works on every plan: Free, Basic, Pro and Ultra.

Parameters

NameTypeAbout
site_idstringOnly for a site shared with you (whoami lists them): read or change that site's data as its member.

Example

Call list_values with these arguments:

{
  "site_id": "01a1…"
}

Ids like 01a1… stand for your own. list_sites and list_tables give you the real ones.

Related guides

  • ValuesSingle facts, such as a total, a status or a token.