# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for WSP Admin Center Wordpress Service API
  version: 1.0.0
extends: openapi/vendasta-wordpressservice-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/v1/wph/admin/wordpress/core'].post
  update:
    x-apievangelist-phrasing:
      intent: Update WordPress core on a hosted site
      effect: write
      questions:
      - How do I upgrade WordPress core on a hosted site to the latest version?
      - Does updating core need both the current and target version numbers?
      instructions:
      - text: Update WordPress core on site {site} from {current} to {latest}.
        slots:
          site: requestBody.siteId
          current: requestBody.coreCurrentVersion
          latest: requestBody.coreLatestVersion
      - text: Upgrade site {site}'s WordPress from version {current} to {latest}.
        slots:
          site: requestBody.siteId
          current: requestBody.coreCurrentVersion
          latest: requestBody.coreLatestVersion
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/wph/admin/wordpress/plugins'].post
  update:
    x-apievangelist-phrasing:
      intent: Update plugins on a WordPress site
      effect: write
      questions:
      - Can I update several WordPress plugins on a site at once?
      - Which plugins will be updated when I run a plugin update?
      instructions:
      - text: Update plugins {plugins} on site {site}.
        slots:
          plugins: requestBody.plugins
          site: requestBody.siteId
      - text: Run plugin updates for {plugins} on WordPress site {site} using method {method}.
        slots:
          plugins: requestBody.plugins
          site: requestBody.siteId
          method: requestBody.method
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/wph/admin/wordpress/themes'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a theme on a WordPress site
      effect: write
      questions:
      - Is there a way to update the theme on a hosted WordPress site?
      - What do I need to supply to update a site's theme?
      instructions:
      - text: Update theme {theme} on site {site}.
        slots:
          theme: requestBody.theme
          site: requestBody.siteId
      - text: Bring WordPress site {site}'s theme {theme} up to date.
        slots:
          site: requestBody.siteId
          theme: requestBody.theme
      method: generated
      generated: '2026-10-01'