# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Pages A/B tests API
  version: 1.0.0
extends: openapi/hubspot-a-b-tests-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/cms/pages/2026-09/landing-pages/ab-test/create-variation'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an A/B test variant of a landing page
      effect: write
      questions:
      - How do I A/B test a HubSpot landing page?
      - Can I create a second version of a landing page to test against the original?
      instructions:
      - text: Create an A/B variation of landing page {contentId} named {variationName}.
        slots:
          contentId: requestBody.contentId
          variationName: requestBody.variationName
      - text: Start an A/B test on landing page {contentId}.
        slots:
          contentId: requestBody.contentId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/ab-test/end'].post
  update:
    x-apievangelist-phrasing:
      intent: End a landing page A/B test and pick a winner
      effect: destructive
      questions:
      - When my landing page test is done, how do I declare the winning version?
      - Can I stop a running A/B test on a landing page?
      instructions:
      - text: End landing page A/B test {abTestId} and make {winnerId} the winner.
        slots:
          abTestId: requestBody.abTestId
          winnerId: requestBody.winnerId
      - text: Stop the landing page test {abTestId}, keeping landing page variant {winnerId}.
        slots:
          abTestId: requestBody.abTestId
          winnerId: requestBody.winnerId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/ab-test/rerun'].post
  update:
    x-apievangelist-phrasing:
      intent: Rerun a past A/B test on a landing page
      effect: write
      questions:
      - Can I restart a landing page A/B test that already ended?
      - How do I bring back a losing landing page variant to test it again?
      instructions:
      - text: Rerun landing page A/B test {abTestId}, reactivating variation {variationId}.
        slots:
          abTestId: requestBody.abTestId
          variationId: requestBody.variationId
      - text: Restart the finished landing page test {abTestId} with landing page {variationId} as the challenger.
        slots:
          abTestId: requestBody.abTestId
          variationId: requestBody.variationId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/site-pages/ab-test/create-variation'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an A/B test variant of a website page
      effect: write
      questions:
      - Is it possible to A/B test a regular website page, not just a landing page?
      - What do I need to supply to add a test version of a site page?
      instructions:
      - text: Create an A/B variation of website page {contentId} named {variationName}.
        slots:
          contentId: requestBody.contentId
          variationName: requestBody.variationName
      - text: Set up an A/B test on site page {contentId}.
        slots:
          contentId: requestBody.contentId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/site-pages/ab-test/end'].post
  update:
    x-apievangelist-phrasing:
      intent: End a website page A/B test and pick a winner
      effect: destructive
      questions:
      - How do I close out an A/B test on a website page and keep the better version?
      - Which ID do I pass to name the winner of a site page test?
      instructions:
      - text: End website page A/B test {abTestId} and designate {winnerId} as the winner.
        slots:
          abTestId: requestBody.abTestId
          winnerId: requestBody.winnerId
      - text: Finish the site page test {abTestId}, keeping site page {winnerId}.
        slots:
          abTestId: requestBody.abTestId
          winnerId: requestBody.winnerId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/site-pages/ab-test/rerun'].post
  update:
    x-apievangelist-phrasing:
      intent: Rerun a past A/B test on a website page
      effect: write
      questions:
      - Can I run an earlier website page A/B test again?
      - How do I reactivate a site page variation from a test that already ended?
      instructions:
      - text: Rerun website page A/B test {abTestId} with variation {variationId} reactivated.
        slots:
          abTestId: requestBody.abTestId
          variationId: requestBody.variationId
      - text: Restart the old site page test {abTestId} using site page {variationId}.
        slots:
          abTestId: requestBody.abTestId
          variationId: requestBody.variationId
      method: generated
      generated: '2026-09-24'