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
| Name | Type | About |
|---|---|---|
site_idrequired | string | The id of the site. list_sites gives the ids of your sites. |
namerequired | string | The action to run, from list_actions. |
row | string | The id of the row to change. Not for an add action. |
values | object | Column values for an edit or add action. |
value | string | The chosen value for a set action. |
params | object | Parameters for a set or fixed action, such as a number of days. |
revision | integer | The row's revision you read. If the row changed since, the action is refused. |
request_id | string | A UUID of your own, so a retry of the same call runs only once. |
idempotency_key | string | Any 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
- Site members and rolesInvite people by email and decide what they may do.