WordPress Connector

List WooCommerce orders, optionally filtered by status.

Get details of a specific WooCommerce order.

List WooCommerce coupons.

Get details of a specific refund on a WooCommerce order.

Get details of a specific WooCommerce coupon.

List configured WooCommerce payment gateways with their status and settings.

List configured WooCommerce shipping zones.

Change the status of a WooCommerce order.

Add a note to a WooCommerce order.

Create a new WooCommerce discount coupon.

Create a refund for a WooCommerce order. Can optionally attempt a payment gateway refund.

Update an existing WooCommerce coupon (code, amount, type, expiry, usage limit).

Create a new blog post as a draft with title and metadata only. Body content is NOT writable through this action because direct post_content writes do not render correctly on page-builder sites (Elementor, Divi, Beaver, etc. store layout in post_meta). To add body content after creation, use wordpress.update_page_text once the post exists, or compose the post in the WP admin.

Create a new page as a draft with title and metadata only. Body content is NOT writable through this action because direct post_content writes do not render correctly on page-builder sites (Elementor, Divi, Beaver, etc. store layout in post_meta). To add body content after creation, use wordpress.update_page_text once the page exists, or compose the page in the WP admin.

Create a new post category.

Create a new post tag.

Upload an image or file to the WordPress media library from a URL or base64 data.

Permanently delete a post.

Permanently delete a page.

Permanently delete a comment.

Remove a single pricing tier from a page by id. Delegates to bridge_delete_block under the hood — included as a named action so the AI surface is symmetric (add / update / remove). Requires Keva Bridge plugin.

Remove a single FAQ item. Gutenberg: deletes the core/details block by id. Elementor: faq_id is composite "{widget_id}:{tab_id}" — reads current tabs, filters out the matching one, patches widget settings. To remove the entire accordion widget itself on Elementor, use bridge_delete_block with the widget id directly. Bridge required.

Delete a testimonial by id. Delegates to bridge_delete_block under the hood — included as a named action for AI-surface symmetry (add / update / remove). Bridge required.

Delete a top-level section from a page by id. Verifies the id IS a root-level child first (so the AI doesn't accidentally remove a column, widget, or nested block via this action — for non-root removals use bridge_delete_block directly). Snapshot-based rollback: the full pre-delete page tree is captured in previousState. Requires Keva Bridge. Gutenberg + Elementor only; other engines return engine_not_supported.

List blog posts, optionally filtered by search term or status.

Get the current content and metadata of a specific post.

List pages, optionally filtered by search term or status.

Get the current content and metadata of a specific page.

List comments, optionally filtered by post or status.

List media library items.

List post categories.

List post tags.

Search blog posts by keyword.

Search pages by keyword.

Search comments by keyword.

List all revisions of a specific post.

Get a specific revision of a post.

List all registered taxonomies (categories, tags, custom taxonomies).

List all registered post types (post, page, custom post types).

Get details of a specific media library item including title, source URL, mime type, and media details.

Detect which page builder (Gutenberg, Elementor, WPBakery, Divi, Avada, Beaver Builder, Bricks, Breakdance, or Classic) a page or post uses.

Search for text across any page builder content. Detects the builder automatically and returns matching elements with their locations.

Probe the Keva Bridge plugin on a WordPress site. Returns Bridge version, available engines (Gutenberg / Elementor / Classic), detected page builders, and active cache plugins. Use this to verify Bridge is installed and to decide whether to prefer bridge_* actions over the legacy update_page_text path.

Read a page through Keva Bridge. Returns the engine discriminator (gutenberg | elementor | classic), the full content tree (parsed blocks for Gutenberg, decoded _elementor_data for Elementor, raw HTML for Classic), plus a writable flag indicating whether Bridge can edit this page.

Compact view of a page through Keva Bridge: IDs + element types + a short hint of visible text. Cheaper than bridge_read_page when the AI just needs to find an element by hint to target a write op.

List all [keva-region] regions discovered across the site. Each entry includes the region id, the post it lives on, current value (or null if untouched), default content, lock state, type (text/html/image/list), and version. Use this to discover what regions the site owner has marked as AI-editable before calling set_region. Optional status filter: "active" (default) | "orphaned" (shortcode removed but value retained) | "all".

Fetch a single [keva-region] by ID. Returns current value, default, lock state, version, full change history, and (if the same region id appears on multiple posts) a duplicates list. Always call this immediately before set_region so you can pass the correct expected_version for optimistic concurrency.

List all image elements that appear in the content of a page (or post). Returns normalized entries with element_id, element_type ("gutenberg:core/image" | "elementor:image" | etc.), current url, alt text, and media library ID where known. Pass each element_id back to update_page_image to swap that specific image. Featured image is included as element_id="featured" unless include_featured=false. With Keva Bridge installed: works on every supported builder. Without Bridge: returns synthetic "img:N" IDs scraped from the rendered HTML (classic-editor pages only).

Update the title or status of an existing post. Does NOT update body content — for content edits use wordpress.update_page_text (find/replace) or wordpress.remove_page_element. Those actions are page-builder aware and work on Elementor, Gutenberg, Divi, Beaver Builder, Bricks, Breakdance, WPBakery, Avada, and classic posts. Writing post_content directly bypasses page builders and produces an invisible no-op on builder-rendered pages.

Update the title or status of an existing page. Does NOT update body content — for content edits use wordpress.update_page_text (find/replace) or wordpress.remove_page_element. Those actions are page-builder aware and work on Elementor, Gutenberg, Divi, Beaver Builder, Bricks, Breakdance, WPBakery, Avada, and classic pages. Writing post_content directly bypasses page builders and produces an invisible no-op on builder-rendered pages.

Update the status or content of a comment (approve, spam, trash).

Restore a post to a previous revision by copying the revision content back to the post.

Update metadata (alt text, caption, description, title) of an existing media item.

Set or remove the featured image on a post or page.

Swap one image that appears on a page (hero image, team photo, etc.) by element_id. Call find_images_on_page first to discover the element_id. Pass EITHER media_id (preferred — the connector resolves the canonical URL + alt from the WP media library) OR a raw url (advanced — bypasses the library, use only for CDN-hosted assets). DIFFERENT from update_media (which only changes library metadata) and set_featured_image (which sets the post thumbnail). Bridge required for builder pages (Elementor / WPBakery / Divi / Beaver / Bricks / Oxygen / Brizy / Cwicly); classic-editor pages with synthetic "img:N" IDs use a regex HTML rewrite (best-effort). If you see element_not_found (404) after a successful find_images_on_page, the page was edited concurrently — re-discover and retry.

Update an existing pricing tier on a page. In v0.1 this uses a delete-and-re-add pattern (the old tier is removed and a new one with the updated fields is added in its place) — the returned tier_id will differ from the input. To change only text within an existing tier without changing its id, use bridge_replace_text. Requires Keva Bridge plugin. Gutenberg + Elementor only. Use get_page / bridge_read_structure first to discover the tier_id.

Update an existing FAQ item. Gutenberg: faq_id is a core/details block id — patches attrs.summary for question changes. For answer-text changes use bridge_replace_text (the answer lives in a child core/paragraph block which v0.1 does not patch directly — a future Bridge release will support nested innerBlocks patches). Elementor: faq_id is "{accordion_widget_id}:{tab_id}" — reads current tabs, replaces the matching tab in place, patches the widget settings. Bridge required.

Update an existing testimonial. Gutenberg: testimonial_id is the core/quote block id — patches attrs.citation for attribution changes (quote-text changes are not supported in v0.1 because the quote lives in a nested paragraph block; use bridge_replace_text for that). Elementor: patches the testimonial widget settings with whatever subset of fields the caller provides (quote → testimonial_content; author_name → testimonial_name; author_role → testimonial_job; attribution → split into name/role if individual fields not supplied). Bridge shallow-merges the settings so untouched fields stay intact.

Create a comment on a WordPress post.

PREFERRED action for editing page/post body content. Performs a find-and-replace on text regardless of which page builder is used — detects Gutenberg blocks, Elementor JSON in post_meta, shortcode-based builders (WPBakery, Divi, Avada), Beaver Builder, Bricks, Breakdance, and classic content automatically, then writes back through the correct storage layer so the change actually renders. Use this for any "change X to Y" or "fix this wording" task. Pair with wordpress.find_text_on_page first if you do not know the exact existing text.

Remove page builder elements (sections, widgets, blocks) that contain specific text. Works across all supported builders.

Find/replace text on a page through Keva Bridge. Engine-aware: edits Gutenberg block innerHTML or Elementor widget settings in place, then triggers the right cache invalidation (Elementor CSS, per-post cache, sitewide post cache, keva/after_content_update hook). Same surface area as wordpress.update_page_text but with verified writes and correct Elementor handling.

Append a new block (Gutenberg) or element (Elementor) to a page. Use this to add a paragraph, heading, image, or section without naive post_content concatenation. Without target_id, the block goes to the end of the page; with target_id, it nests inside the matching container. Solves the "append a sentence" gap from PR-1.

Token-saver wrapper around bridge_append_block for the most common case: appending a paragraph of text to a page. Pass post_id and text; the connector picks the right block shape automatically based on the page engine (core/paragraph for Gutenberg, text-editor widget for Elementor). HTML in the text is escaped — pass HTML through bridge_append_block if raw markup is needed.

PATCH-style update of a single block/element by ID. Use bridge_read_structure first to find the target ID. For Gutenberg, replaces attrs + innerHTML. For Elementor, shallow-merges into element.settings. Leaf blocks/widgets only — use bridge_replace_text for find/replace across the page.

Remove a single block/element by ID. Use bridge_read_structure to find the target ID first. Returns 404 if the ID is no longer in the tree (e.g. someone else already removed it).

Set a [keva-region]'s current value. PREFERRED over update_page_text when the target is a known region id — works on ANY page builder. Pass expected_version (from a recent get_region) for optimistic concurrency — the write fails with version_conflict (409) if the stored version has advanced. Regions declared with lock="true" require human_approved: true after the human-approval flow. When the same region id exists on multiple posts, pass post_id explicitly or the call returns ambiguous_region (400).

Append a new pricing tier to a page (e.g. "Add a Pro tier at $29/mo with 5 features and a Sign up button"). On Gutenberg, builds a core/column with heading + price + feature-list + button and appends it into target_id (an existing core/columns block) — when target_id is omitted, creates a fresh core/columns row at the end of the page with the new tier inside. On Elementor (free pattern, works without Pro), builds an Elementor column with heading + heading + icon-list + button widgets — appends into target_id (an existing section) or wraps in a new section. Requires Keva Bridge plugin (BRIDGE_NOT_CONFIGURED returned otherwise). For builders other than Gutenberg/Elementor, returns a graceful error pointing at bridge_append_block. Returns the new tier_id which you can pass to remove_pricing_tier / update_pricing_tier later.

Add a single question/answer to a page. On Gutenberg: appends one core/details block (each FAQ is its own block — uses WP 6.3+ native accordion primitive). On Elementor: when target_id points at an existing accordion widget, appends a new tab into its tabs[] array (read-modify-write the widget settings). When target_id is omitted on Elementor, creates a fresh accordion widget with one starter tab. Requires Keva Bridge. Other 7 builders return WIDGET_PATTERN_UNSUPPORTED.

Append a testimonial to a page. Gutenberg: builds a core/quote block (quote → child paragraph; attribution → citation attr). Elementor: builds a testimonial widget (testimonial_content / testimonial_name / testimonial_job). The attribution string is preferred — when provided it overrides separate author_name/author_role on Gutenberg; on Elementor the discrete fields drive the widget settings and are populated from attribution (split on the first comma) when not supplied. Requires Keva Bridge.

Append an empty top-level section to the end of a page. The connector picks the engine-correct empty container shape (core/group with constrained layout on Gutenberg; elType:container or section on Elementor). Returns the new section_id which you can pass to subsequent bridge_append_block / bridge_append_text / widget actions (add_pricing_tier, add_faq_item, add_testimonial) to fill the section. Use this when the AI wants a fresh wrapper to drop new content into rather than crafting the engine-specific JSON by hand. Requires Keva Bridge (no new PHP endpoint — uses /append-block). For engines other than Gutenberg/Elementor, returns engine_not_supported.

Deep-clone a section by id and insert the clone immediately after the source. For Elementor, every nested element id is regenerated server-side to a fresh 8-hex (sharing ids breaks Elementor's editor). For Gutenberg the clone gets a fresh deterministic blk_xxxxxxxx id derived from its post-splice path. Atomic single save_post. Returns the new duplicated_id which you can pass to subsequent update_section calls to vary the cloned content. Requires Keva Bridge ≥0.7.0. Gutenberg + Elementor only; other engines return engine_not_supported.

Atomically reorder top-level sections (or, when parent_id is supplied, the children of a specific container) to match ordered_ids. The ordered_ids array MUST be a permutation of the current root-level ids — if it isn't the call returns invalid_order with the actual current ids embedded in the error so the AI can re-read + retry. Single save_post per call (no partial-state risk). Requires Keva Bridge ≥0.7.0. Gutenberg + Elementor only; other engines return engine_not_supported.

Permanently delete a WooCommerce coupon.

Update a WooCommerce customer (name, email, billing/shipping).

List installed plugins with status, version, and other metadata.

Get details of a specific installed plugin.

List installed themes with status and metadata.

Get details of a specific installed theme.

Get WooCommerce system status including WP version, PHP version, DB info, active plugins, and theme info.

List application passwords for a user. Returns names and creation dates (not actual passwords). Useful for auditing API access.

Get WordPress site settings including title, description, URL, timezone, date/time format, and language.

Read the active theme's site-wide design tokens (theme.json). For block themes, returns the merged settings + styles (palette, fontFamilies, default typography, per-element overrides) along with is_block_theme:true and the global_styles_id used by subsequent updates. For classic themes, returns is_block_theme:false plus the small subset of color settings exposed via /wp/v2/settings — most classic-theme customizer mods are not yet AI-editable (planned for PR-10.1 with Bridge).

Convenience read: returns just the named color palette declared by the active theme. Each entry has { slug, name, color }. Use the slug as the target for update_brand_color. On classic themes, returns a small derived palette built from the WordPress site settings (background_color, header_textcolor).

Convenience read: returns the font families declared by the active block theme. Each entry has { slug, name, fontFamily }. Use the slug as the target for update_font_family. Returns unsupported_classic_theme on classic themes — font-family editing for classic themes requires Bridge (planned for PR-10.1).

Activate an installed WordPress plugin.

Deactivate an active WordPress plugin.

List notes on a WooCommerce order.

List refunds for a WooCommerce order.

List WooCommerce products.

Get details of a specific WooCommerce product.

List WooCommerce product categories.

List WooCommerce product reviews, optionally filtered by product.

List variations of a variable WooCommerce product.

Get a specific variation of a WooCommerce product.

Get a specific WooCommerce product review.

List WooCommerce product tags.

Update a WooCommerce product (name, price, stock, status, etc.).

Update a WooCommerce product category (name, description, display, parent).

Permanently delete a WooCommerce product review.

Create a new WooCommerce product.

Permanently delete a WooCommerce product.

Update a WooCommerce product variation (price, stock, SKU).

Create a new variation for a variable WooCommerce product.

Update a WooCommerce product review (status, content).

Create a WooCommerce product tag.

Change one named color in the active theme's palette by slug (e.g. "primary", "secondary", "accent"). Affects every block, button, link, and element that references this slug via var(--wp--preset--color--<slug>). Call get_brand_colors first to discover valid slugs. Returns { slug, previous, current } for audit/rollback. Block themes only — classic themes return unsupported_classic_theme (planned for PR-10.1 with Bridge).

Change the font family used by a given element slot (body, heading, h1..h6, button, caption, link). The new font_family_slug must already exist in the theme's declared fontFamilies (use list_font_families to discover them). The slot is updated to var(--wp--preset--font-family--<slug>). Block themes only — classic themes return unsupported_classic_theme.

List WordPress users.

List WooCommerce customers.

Get details of a specific WooCommerce customer.

Get details of a specific WordPress user including name, email, and roles.

Update a WordPress user (name, email, role).