updateMenuItem
Idempotent
Update a menu item's name, link, order, or active status by providing its ID; fields not included remain unchanged.
Instructions
Update a menu item - Update an existing menuitem record by ID. Fields omitted are untouched. Writes live data.
Use when: renaming, re-linking (change menu_link), reordering (change menu_order), or hiding (change menu_active=0).
Required: menu_item_id.
See also: createMenuItem (add new), deleteMenuItem (remove permanently).
Returns: { status: "success", message: {...updatedRecord} } - the full updated record after changes applied.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| menu_item_id | Yes | ||
| menu_name | No | Display text — the visible menu link label. Supports `[widget=Name]` shortcodes. | |
| menu_link | No | URL or path | |
| menu_order | No | ||
| menu_active | No | ||
| _clear_fields | No | Column names to clear to empty string. Available on every `update*` operation. Works on base columns AND EAV/`users_meta` rows (rows preserved with `value=""`). To actually clear a field you MUST use this parameter — sending the field with `""` alone is a no-op (BD drops empty values). To remove a `users_meta` row entirely, use `deleteUserMeta`. See **Rule: Clearing fields**. Example: `_clear_fields: ["h2", "hero_link_url"]`. |