pagehive

run_action

On a site shared with you with role edit or higher: run one of the site's visitor actions as its member, exactly as a click on the page would.

Shared sitesChanges dataAll plans

What it does

On a site shared with you with role edit or higher: run one of the site's visitor actions as its member, exactly as a click on the page would. Only actions with access member_own, member_all or public. A row you add belongs to you; member_own changes only your own rows. Send row for an existing row, values for edit and add, value and params for set and fixed, revision to refuse a stale edit, and request_id (a UUID) so a retry runs once. list_actions lists them.

Plans

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

Parameters

NameTypeAbout
site_idrequiredstringThe id of the site. list_sites gives the ids of your sites.
namerequiredstringThe action to run, from list_actions.
rowstringThe id of the row to change. Not for an add action.
valuesobjectColumn values for an edit or add action.
valuestringThe chosen value for a set action.
paramsobjectParameters for a set or fixed action, such as a number of days.
revisionintegerThe row's revision you read. If the row changed since, the action is refused.
request_idstringA UUID of your own, so a retry of the same call runs only once.
idempotency_keystringAny unique string (1-200 printable ASCII). A retry with the same key and arguments returns the first call's result instead of running again. Same as the Idempotency-Key header.

Example

Call run_action with these arguments:

{
  "site_id": "01a1…",
  "name": "toggle_done",
  "row": "01a1…"
}

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

Related guides