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
| Name | Type | About |
|---|---|---|
keyrequired | string | The value to move to another site. |
to_site_idrequired | string or null | A site id from list_sites, or null for the account. |
keep_access | boolean | Give the old owner a read_write share and sites whose pages read it a read share. Default false. |
dry_run | boolean | Return 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.