# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Wsp Support Tools Site Manager API
  version: 1.0.0
extends: openapi/vendasta-sitemanager-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: 5
- target: $.paths['/v1/wph/support-tools/chat'].post
  update:
    x-apievangelist-phrasing:
      intent: Ask the site support assistant a question
      effect: read
      questions:
      - Can I get an AI chat answer to a WordPress hosting support question?
      - Is there a support-tools chat I can send free text to?
      instructions:
      - text: 'Ask the site support chat: {text}'
        slots:
          text: requestBody.text
      - text: Get a chat completion for the support prompt {text}.
        slots:
          text: requestBody.text
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/wph/support-tools/plugins'].post
  update:
    x-apievangelist-phrasing:
      intent: List plugins installed on a site
      effect: read
      questions:
      - Which WordPress plugins are installed on my hosted site?
      - Can I page through a site's installed plugin list?
      instructions:
      - text: List the plugins installed on site {siteId}.
        slots:
          siteId: requestBody.siteId
      - text: Show {pageSize} installed plugins for site {siteId}.
        slots:
          pageSize: requestBody.pageSize
          siteId: requestBody.siteId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/wph/support-tools/plugins/activate'].post
  update:
    x-apievangelist-phrasing:
      intent: Activate plugins on a site
      effect: write
      questions:
      - Can I turn on several installed plugins for a site in one request?
      - What's needed to enable a plugin on a hosted WordPress site?
      instructions:
      - text: Activate plugins {pluginIds} on site {siteId}.
        slots:
          pluginIds: requestBody.pluginIds
          siteId: requestBody.siteId
      - text: Enable plugin {pluginIds} for site {siteId}.
        slots:
          pluginIds: requestBody.pluginIds
          siteId: requestBody.siteId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/wph/support-tools/plugins/deactivate'].post
  update:
    x-apievangelist-phrasing:
      intent: Deactivate plugins on a site
      effect: write
      questions:
      - Can I switch off a misbehaving plugin on my site remotely?
      - Is it possible to deactivate a list of plugins at once?
      instructions:
      - text: Deactivate plugins {pluginIds} on site {siteId}.
        slots:
          pluginIds: requestBody.pluginIds
          siteId: requestBody.siteId
      - text: Turn off plugin {pluginIds} for site {siteId}.
        slots:
          pluginIds: requestBody.pluginIds
          siteId: requestBody.siteId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/wph/support-tools/resource-usage'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a site's monthly resource usage
      effect: read
      questions:
      - How much hosting resource did my site consume this month?
      - Can I see a site's resource usage summary for a past month?
      instructions:
      - text: Get the resource usage summary for site {siteId}.
        slots:
          siteId: requestBody.siteId
      - text: Show resource usage for site {siteId} in {monthYear}.
        slots:
          siteId: requestBody.siteId
          monthYear: requestBody.monthYear
      method: generated
      generated: '2026-10-01'