# Divi 5 Module API Calls — Complete Agent Reference

Everything an AI agent needs to build Divi 5 modules programmatically — every API endpoint, block attribute path, DiviOps tool, pattern, limitation, and gotcha. Compiled from 32 skill files, 2 wiki pages, and real production deployments.

Source files (all read 2026-07-05): - `/home/kaburu/.hermes/skills/infrastructure/divi-5-builder/SKILL.md` (649 lines) - `/home/kaburu/.hermes/skills/infrastructure/divi-5-builder/references/` (19 reference files) - `/home/kaburu/.hermes/skills/infrastructure/divi-5-builder/scripts/` (7 scripts) - `/home/kaburu/.hermes/skills/infrastructure/divi-5-builder/templates/page-blueprints.yaml` (361 lines) - `/home/kaburu/wiki/wiki/web/divi-5-lessons.md` (436 lines) - `/home/kaburu/wiki/wiki/projects/divi-5-builder-bot.md` (312 lines)

—

## 1. DiviOps MCP Tools — All 85 Free Tools

Package: `@diviops/mcp-server` v1.5.33 (MIT license, free) Plugin: `diviops-agent` v1.5.5 (free, WordPress plugin) Base REST path: `https://<site>/wp-json/diviops/v1/`

Key fact: Pro is NOT needed. All 85 execution tools ship free. Pro sells curated reference docs (boxShadow, filters, transform, sticky, scroll, animation), which can be discovered via `diviops_schema_get_module(raw=true)`.

### Page Authoring (12 tools)

### Module Operations (5 tools)

### Design System (~15 tools)

### Validation & Preview (3 tools)

### Schema (3 tools)

### Theme Builder (4 tools)

### Library, Canvas, Menu, Meta (~20 tools)

### Templates (2 tools)

Pre-verified templates: `hero-centered`, `features-blurbs`, `cta-gradient`, `cards-flex`

### Site-connected MCP Servers (as of 2026-07-04)

—

## 2. WordPress REST API Endpoints

### DiviOps Plugin REST API All paths under `https://<site>/wp-json/diviops/v1/`:

### RankMath REST API Base: `https://<site>/wp-json/rankmath/v1/` — Auth: WordPress app password (Basic Auth)

RankMath postmeta keys (settable via `wp post meta update`): `rank_math_focus_keyword`, `rank_math_title`, `rank_math_description`, `rank_math_facebook_title`, `rank_math_facebook_description`, `rank_math_facebook_image`, `rank_math_twitter_title`, `rank_math_twitter_description`, `rank_math_twitter_image`, `rank_math_canonical_url`, `rank_math_robots`

Note: RankMath has NO WP-CLI commands — REST API or direct postmeta writes only.

### RankWatch API Base: `https://apiv2.rankwatch.com/{path}/{json|xml}/{params}/` Auth: Basic HTTP (`token:password`). All paths require trailing slash.

### WordPress Core REST API `POST https://<site>/wp-json/wp/v2/media` — Upload media (used for image pipeline)

### chippy-bridge Custom REST API Namespace: `chippy/v1` (public read access)

### ComfyUI Local API - `POST http://localhost:8188/prompt` — Send workflow (returns prompt_id) - `GET http://localhost:8188/history/{prompt_id}` — Poll for completion - `GET http://localhost:8188/view?filename=…` — Fetch output image

—

## 3. Divi Block JSON Attribute Paths

### Block Structure (Every Block) ```python {

  "module": {
      "decoration": { ... },   # Visual styling
      "advanced": { ... },     # Advanced settings
      "content": { ... }       # Some modules
  },
  "builderVersion": "5.0.3"   # BLOCK SPEC version, NOT theme version

} ```

### Module Decoration Paths

### Padding/Margin Sub-paths ``` module.decoration.spacing.desktop.value.padding.top module.decoration.spacing.desktop.value.padding.right module.decoration.spacing.desktop.value.padding.bottom module.decoration.spacing.desktop.value.padding.left module.decoration.spacing.desktop.value.padding.syncVertical module.decoration.spacing.desktop.value.padding.syncHorizontal ```

### Gradient Sub-paths ``` module.decoration.background.desktop.value.gradient.enabled # “on”/“off” module.decoration.background.desktop.value.gradient.direction # “180deg” module.decoration.background.desktop.value.gradient.stops[] # [{color, position}] ```

### Content Decoration Paths (Text Module)

### Text Content Path `content.innerContent.desktop.value` — The HTML string for text modules. This is the single most common path error.

### Button Module Paths

### Image Module Paths

### Advanced Module Paths ``` module.advanced.text.text.desktop.value.color # Text color module.advanced.text.font.desktop.value.fontSize # Font size module.advanced.text.font.desktop.value.font # Font family module.advanced.type.desktop.value # Column width (e.g. “4_4”, “1_2”) ```

### headingFont Nesting Trap (CRITICAL) ```python # WRONG — bodyFont ends up inside h1, missing closing braces: {“headingFont”: {“h1”: {“font”: {“desktop”: {…}, “tablet”: {…}, “phone”: {…}}}, “bodyFont”: {…}}}

# CORRECT — bodyFont is sibling of h1, proper closing: {“headingFont”: {“h1”: {“font”: {“desktop”: {…}, “tablet”: {…}, “phone”: {…}}}}, “bodyFont”: {…}} ```

### Unicode Escapes in innerContent

—

## 4. Create vs Modify Rules — THE CARDINAL RULE

### MODIFY existing VB-created blocks via REST API = WORKS ✅ - Batch text updates across many pages - Style migration (spacing, colors, typography) - Content replacement (placeholder text → real copy) - Stripping inline styles → moving to block JSON attributes - VB reads updated block JSON on next open and renders correctly

### CREATE new blocks via REST API = INVISIBLE in VB ❌ - Content renders on frontend (perfectly) - VB Layers panel shows only a single empty “section” - Client CANNOT select, move, or edit programmatically-created blocks - Why: Divi 5 blocks do NOT register in Divi's internal React state. VB loads content into its own state management layer; blocks not created there are invisible.

### Workflow Decision Matrix

### Page Build Architecture (for programmatic pages) The `gen-divi-page.py` script generates block markup with `json.dumps()` (guarantees correct JSON), writes to file, SCPs to Hetzner, and pushes via `wp post update`. Pages render on frontend. For pages that need VB editing, create structure manually in VB first.

L8 Water Hygiene deployment (proven): 62 blocks, 6 sections, 21/22 content strings verified, `wp post update` → `wp post meta update` → `wp cache flush`.

—

## 5. Visual Builder Architecture

### Dual-Frame Layout ``` Parent Window (React app) ├── Sidebar, settings panel, toolbar, layers panel, TinyMCE ├── Iframe: #et-vb-app-frame │ ├── Page canvas/preview DOM │ ├── wp.* (WordPress core — NO wp.data) │ ├── DIVI object (builder config, item counts, selectors) │ ├── ET_Builder object (API, Frames, Misc) │ └── window.divi.data (read-only state registry) └── React root: #et-vb-app-frame-wrapper ```

### window.divi.data — Read-Only State Registry ```javascript var store = window.divi.data.select('divi/edit-post');

store.getAllModuleIds(); // Array of all module IDs on page store.getModuleName(id); // 'divi/text', 'divi/section', etc. store.getModuleType(id); // 'module', 'section', 'row', 'column' store.getModuleAttrs(id); // Full attributes object ```

Key characteristics: - READ ONLY — no public API for writing state - Module IDs are EPHEMERAL — change on every page reload - `wp.data.select()` and `wp.data.dispatch()` are NOT available - `window.divi.data` is the ONLY way to programmatically read VB state

### State Management Rules 1. Read — via `window.divi.data.select('divi/edit-post')` 2. Write — ONLY via UI interaction (clicks, keyboard input in VB) 3. Modify existing blocks — via REST API (modifying block JSON in post_content) 4. Create new blocks — ONLY via Playwright browser automation (VB UI) 5. Verify — use `window.divi.data` to confirm state after UI actions 6. Never hardcode module IDs — they're ephemeral per session

### Playwright VB Automation (reference — not primary workflow) ``` # Open VB: https://site.com/?p={page_id}&et_fb=1&PageSpeed=off # Structure Shortcut: press 's' then '1' = section with 1 row # Save: Meta+s (Cmd+S) ```

### Browser Automation Tool: Web MCP Web MCP (`chrome://flags/#web-mcp-for-testing`) replaces Playwright for browser-dependent tasks: - Login to WordPress admin - Open Visual Builder manually - Take screenshots of live pages - Interact with non-Divi UI (settings, plugins)

Hosted on kaburu-laptop (192.168.0.142), flag enabled as of 2026-07-04. MCP server: `chromium-webmcp` (disable — needs Chromium running).

—

## 6. Auth Patterns

### Pattern 1: WordPress Application Password (PRIMARY) ```bash # Create wp user application-password create kaburu “diviops-mcp” –allow-root # Returns: Password: XXXXXXXXXXXXXXXX ``` Used for: DiviOps MCP, RankMath REST API, ComfyUI image uploads

API usage: ```python import base64 credentials = base64.b64encode(f”username:app_password“.encode()).decode() headers = {“Authorization”: f”Basic {credentials}“} ```

### Pattern 2: Cookie Auth (for browser-based access) Generate auth cookies server-side to bypass login restrictions (Wordfence, LiteSpeed, Cloudflare): ```bash php -r ' require_once(“wp-load.php”); $user = get_user_by(“login”, “USERNAME”); $hash = COOKIEHASH; $logged_in = wp_generate_auth_cookie($user→ID, time()+7200, “logged_in”); $auth = wp_generate_auth_cookie($user→ID, time()+7200, “auth”); echo “COOKIEHASH=”.$hash.”\nLOGGED_IN=“.$logged_in.”\nAUTH=“.$auth.”\n“; ' ```

Inject into browser: `wordpress_{hash}`, `wordpress_logged_in_{hash}`, `wordpress_sec_{hash}` cookies.

### Pattern 3: WP-CLI Application Password Lifecycle Old app passwords can start returning 401. Create fresh ones if uploads fail: ```bash wp –path=/home/{site}/public_html –allow-root user application-password create kaburu “divi-bot-pipeline” ```

### Pattern 4: wpApiSettings.nonce (for VB context) ```javascript // Inside VB iframe, use wpApiSettings.nonce for authenticated REST calls // Avoids Authorization header issues specific to VB context wp.apiRequest({ path: '/wp/v2/pages/' + pageId, method: 'PUT', data: { … } }); ```

### Known Active App Passwords

—

## 7. Known Limitations & Gotchas

### HARD RULES (Never Violate)

### SOFT RULES (Breaking These Wastes Time)

### Server/Infrastructure Gotchas

—

## 8. Agent Cheat Sheet

### Build a Page (Complete Pipeline) ```bash # 1. Generate blocks with Python (guarantees correct JSON) python3 gen-divi-page.py # Output: /tmp/divi-page-output.html

# 2. SCP to Hetzner via Tailscale scp -i /opt/hermes/config/hetzner_id_ed25519 /tmp/divi-page-output.html [email protected]:/tmp/

# 3. Push to WordPress ssh -i /opt/hermes/config/hetzner_id_ed25519 [email protected] '

cd /home/{site}/public_html
PAGE_ID=$(wp post create --post_type=page --post_title="Page Title" --post_status=draft --porcelain --allow-root)
wp post update $PAGE_ID /tmp/divi-page-output.html --allow-root
wp post meta update $PAGE_ID _et_pb_use_builder on --allow-root
wp post meta update $PAGE_ID _et_pb_page_layout et_full_width_page --allow-root
wp post update $PAGE_ID --post_status=publish --allow-root
wp cache flush --allow-root

'

# 4. Verify curl -sL https://{site}/?page_id={ID} | grep -o 'expected text' | sort -u

# 5. Visual QA (skip for auth-walled pages) python3 /home/kaburu/scripts/vision-check.py https://{site}/{slug} ```

### Python Block Generator Template ```python import json

def text_block(module_deco, content_deco, inner_content):

  obj = {
      "module": {"decoration": module_deco},
      "content": {
          "decoration": content_deco,
          "innerContent": {"desktop": {"value": inner_content}}
      },
      "builderVersion": "5.0.3"
  }
  return f'<!-- wp:divi/text {json.dumps(obj, ensure_ascii=False)} /-->'

def button_block(module_deco, button_obj):

  obj = {
      "module": {"decoration": module_deco},
      "button": button_obj,
      "builderVersion": "5.0.3"
  }
  return f'<!-- wp:divi/button {json.dumps(obj, ensure_ascii=False)} /-->'

def section_block(module_deco, children):

  obj = {"module": {"decoration": module_deco}, "builderVersion": "5.0.3"}
  return f'<!-- wp:divi/section {json.dumps(obj, ensure_ascii=False)} -->\n{children}\n<!-- /wp:divi/section -->'

def row_block(module_deco, children):

  obj = {"module": {"decoration": module_deco}, "builderVersion": "5.0.3"}
  return f'<!-- wp:divi/row {json.dumps(obj, ensure_ascii=False)} -->\n{children}\n<!-- /wp:divi/row -->'

def column_block(module_advanced, module_deco, children):

  obj = {"module": {"advanced": module_advanced, "decoration": module_deco}, "builderVersion": "5.0.3"}
  return f'<!-- wp:divi/column {json.dumps(obj, ensure_ascii=False)} -->\n{children}\n<!-- /wp:divi/column -->'

# Presets LAYOUT_BLOCK = {“layout”: {“desktop”: {“value”: {“display”: “block”}}}} def bg_color(color):

  return {"background": {"desktop": {"value": {"color": color}}}}

def padding(top=”“, right=”“, bottom=”“, left=”“):

  return {"spacing": {"desktop": {"value": {"padding": {
      "top": top, "right": right, "bottom": bottom, "left": left,
      "syncVertical": "off", "syncHorizontal": "off"
  }}}}}

```

### Modify Existing Block via DiviOps MCP ```python # Update text color on a specific module diviops_module_update(

  page_id=123,
  auto_index=5,
  attrs={"module.advanced.text.text.desktop.value.color": "#333333"}

)

# Update text content diviops_module_update(

  page_id=123,
  auto_index=3,
  attrs={"content.innerContent.desktop.value": "<p>New text here</p>"}

)

# Flush cache after changes diviops_meta_flush_cache(post_id=123) ```

### WP-CLI Quick Reference ```bash # Create app password wp user application-password create kaburu “diviops-mcp” –allow-root

# Set Divi postmeta wp post meta update PAGE_ID _et_pb_use_builder on –allow-root wp post meta update PAGE_ID _et_pb_page_layout et_full_width_page –allow-root

# Set home page wp option update page_on_front PAGE_ID –allow-root wp option update show_on_front page –allow-root

# Set permalinks wp rewrite structure '/%postname%/' –allow-root

# Set RankMath SEO meta wp post meta update PAGE_ID rank_math_focus_keyword “keyword here” –allow-root wp post meta update PAGE_ID rank_math_title “SEO Title” –allow-root wp post meta update PAGE_ID rank_math_description “Meta description” –allow-root

# Flush all caches wp cache flush –allow-root

# Debug block JSON wp eval ' $c = get_post_field(“post_content”, PAGE_ID); preg_match(”/<!– wp:divi\/text.*?\/–>/“, $c, $m); $s = substr($m[0], 18, -4); $d = json_decode($s, true); echo ($d === null) ? “FAIL: ”.json_last_error_msg() : “OK”; ' –allow-root

# Build a new MCP server wp –path=/home/{site}/public_html –allow-root plugin install /tmp/diviops-agent.zip –activate wp –path=/home/{site}/public_html –allow-root user application-password create kaburu “diviops-mcp” # Then register in ~/.hermes/config.yaml via Python YAML manipulation ```

### DiviFlash Module Usage Pattern ```python # 1. Read schema from server # cat wp-content/plugins/diviflash/Builder/Server/modules-json/<Module>/module.json

# 2. Write as block comment difl_block = '<!– wp:difl/faq {“module”: { “decoration”: { “background”: {“desktop”: {“value”: {“color”: ”#ffffff“}}}, “spacing”: {“desktop”: {“value”: {“padding”: {“top”: “40px”, “bottom”: “40px”}}}} } }, “faq_que_text_tab”: “Question here”, “faq_ans_text_tab”: “Answer here”, “builderVersion”: “5.0.3”} /–>'

# 3. Save via DiviOps (may not preview — VERIFY on frontend) diviops_page_update_content(page_id=123, content=difl_block) # Verify: curl -sL https://site.com/?page_id=123 ```

### Image Upload Pipeline ```bash # Full generate+upload (ComfyUI primary, DALL-E 3 fallback) python3 /home/kaburu/.hermes/skills/infrastructure/divi-5-builder/scripts/comfyui-generate.py \

1. -prompt “professional description of image” \
2. -output /tmp/hero.png \
3. -width 1280 –height 720 \
4. -upload-site l8.kaburu.co.uk \
5. -alt-text “Image description” \
6. -title “Image Title”

# Returns: attachment_id + URL ```

### SEO After Page Build ```bash # Set meta python3 /home/kaburu/.hermes/skills/infrastructure/divi-5-builder/scripts/rankmath-seo.py \

set-meta --site kaburu.co --post-id 100 --keyword "keyword" \
--title "SEO Title Here" --description "Meta description here"

# Set schema python3 /home/kaburu/.hermes/skills/infrastructure/divi-5-builder/scripts/rankmath-seo.py \

set-schema --site kaburu.co --post-id 100 --type Service

# Full SEO (all-in-one) python3 /home/kaburu/.hermes/skills/infrastructure/divi-5-builder/scripts/rankmath-seo.py \

full-seo --site kaburu.co --post-id 100 --keyword "keyword" \
--title "SEO Title" --description "Meta desc"

```

### Schema Discovery (Replaces DiviOps Pro) ```python # Get full attribute tree for any module diviops_schema_get_module(module_name=“divi/text”, raw=True) # Returns: boxShadow, filters, transform, sticky, scroll, animation, # transition, zIndex, and every decoration path

# Dump all schemas diviops_schema_get_module(mode=“dump_all”) # Returns every module's schema + schema_version hash ```

### MCP Server Registration (Hermes Config) ```python # CRITICAL: Do NOT use `hermes mcp add` — it mangles multi-arg commands import yaml with open('/home/kaburu/.hermes/config.yaml', 'r') as f:

  config = yaml.safe_load(f)

config['mcp_servers']['diviops-{site-name}'] = {

  'command': 'npx',
  'args': ['-y', '--package', '@diviops/mcp-server', 'diviops-mcp'],
  'env': {
      'WP_URL': 'https://{site-domain}',
      'WP_USER': 'kaburu',
      'WP_APP_PASSWORD': '{password}'
  },
  'enabled': True

}

with open('/home/kaburu/.hermes/config.yaml', 'w') as f:

  yaml.dump(config, f, default_flow_style=False, sort_keys=False)

# Then: hermes mcp test diviops-{site-name} # Then: /reset session — no live reload exists ```

—

## External References - 16wells Divi 5 Docs: https://16wells.github.io/divi-docs/ - DiviOps GitHub: https://github.com/oaris-dev/diviops - DiviOps npm: `@diviops/mcp-server` - RankWatch API Docs: https://www.rankwatch.com/rwapi/doc.html - OpenLiteSpeed + Wordfence: https://openlitespeed.org/kb/enable-wordfence-on-openlitespeed/