pagehive

move_value

Move a value between the account and a site, or from one site to another.

ValuesChanges dataAll plans

What it does

Move a value between the account and a site, or from one site to another. Full account keys only. to_site_id is a site id from list_sites, or null for the account. Every site reads account values in a page render, but only the owner and sites with a share read a site value, and a site key never reads account values. The move is refused, and nothing changes, when pages on other sites read it and keep_access is not true. keep_access true gives the old owner a read_write share and those other sites a read share. A share to the new owner is removed. dry_run true returns the plan without moving.

Plans

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

Parameters

NameTypeAbout
keyrequiredstringThe value to move to another site.
to_site_idrequiredstring or nullA site id from list_sites, or null for the account.
keep_accessbooleanGive the old owner a read_write share and sites whose pages read it a read share. Default false.
dry_runbooleanReturn the plan without moving. Default false.

Example

Call move_value with these arguments:

{
  "key": "opening_hours",
  "to_site_id": "01a1…",
  "dry_run": true
}

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.