# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Landing pages API
  version: 1.0.0
extends: openapi/hubspot-landing-pages-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: 11
- target: $.paths['/cms/pages/2026-09/landing-pages'].get
  update:
    x-apievangelist-phrasing:
      intent: List landing pages
      effect: read
      questions:
      - How do I get a list of every landing page in my HubSpot account?
      - Can I filter landing pages to only those updated since last week?
      - Which landing pages were created before a certain date?
      instructions:
      - text: List all of my landing pages.
      - text: List landing pages created after {createdAfter}, sorted by {sort}.
        slots:
          createdAfter: query.createdAfter
          sort: query.sort
      - text: Page through landing pages {limit} at a time starting after cursor {after}.
        slots:
          limit: query.limit
          after: query.after
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a landing page
      effect: write
      questions:
      - How do I build a brand-new landing page through the API?
      - Can I pick the template and URL slug when creating a new landing page?
      instructions:
      - text: Create a new landing page named {name} using template {templatePath}.
        slots:
          name: requestBody.name
          templatePath: requestBody.templatePath
      - text: Create a landing page {name} at slug {slug} with meta description {metaDescription}.
        slots:
          name: requestBody.name
          slug: requestBody.slug
          metaDescription: requestBody.metaDescription
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/clone'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a landing page
      effect: write
      questions:
      - Can I duplicate an existing landing page instead of starting from scratch?
      - What's the quickest way to make a copy of a landing page under a new name?
      instructions:
      - text: Clone landing page {id}.
        slots:
          id: requestBody.id
      - text: Make a copy of landing page {id} called {cloneName}.
        slots:
          id: requestBody.id
          cloneName: requestBody.cloneName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/schedule'].post
  update:
    x-apievangelist-phrasing:
      intent: Schedule a landing page to publish
      effect: write
      questions:
      - How do I set a landing page to go live at a future date?
      - Can I schedule when a landing page gets published instead of publishing it now?
      instructions:
      - text: Schedule landing page {id} to publish at {publishDate}.
        slots:
          id: requestBody.id
          publishDate: requestBody.publishDate
      - text: Queue landing page {id} to go live on {publishDate}.
        slots:
          id: requestBody.id
          publishDate: requestBody.publishDate
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/{objectId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a live landing page
      effect: read
      questions:
      - How can I pull the details of one specific landing page by its ID?
      - Can I fetch just certain properties of a single landing page?
      instructions:
      - text: Show me landing page {objectId}.
        slots:
          objectId: path.objectId
      - text: Get the {property} of landing page {objectId}.
        slots:
          property: query.property
          objectId: path.objectId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/{objectId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a landing page
      effect: destructive
      questions:
      - Can I delete a landing page I no longer need?
      - What's involved in removing an old landing page from my account?
      instructions:
      - text: Delete landing page {objectId}.
        slots:
          objectId: path.objectId
      - text: Remove the landing page with ID {objectId}.
        slots:
          objectId: path.objectId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/{objectId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a live landing page
      effect: write
      questions:
      - How do I change the title or meta description of a published landing page directly?
      - Can I update only a few fields of a landing page without resending everything?
      instructions:
      - text: Change the HTML title of landing page {objectId} to {htmlTitle}.
        slots:
          objectId: path.objectId
          htmlTitle: requestBody.htmlTitle
      - text: Move landing page {objectId} into folder {folderId}.
        slots:
          objectId: path.objectId
          folderId: requestBody.folderId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/{objectId}/draft'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a landing page's draft version
      effect: read
      questions:
      - Where can I see the unpublished draft edits of a landing page?
      - Can I review a landing page's draft before it gets pushed live?
      instructions:
      - text: Show the draft version of landing page {objectId}.
        slots:
          objectId: path.objectId
      - text: Get the pending unpublished draft for landing page {objectId}.
        slots:
          objectId: path.objectId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/{objectId}/draft'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a landing page's draft
      effect: write
      questions:
      - How do I stage changes to a landing page without touching the live version?
      - Can I edit a landing page draft and publish it later?
      instructions:
      - text: In the draft of landing page {objectId}, set the meta description to {metaDescription}.
        slots:
          objectId: path.objectId
          metaDescription: requestBody.metaDescription
      - text: Update the draft of landing page {objectId} so its name is {name}.
        slots:
          objectId: path.objectId
          name: requestBody.name
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/{objectId}/draft/push-live'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish a landing page's draft changes
      effect: write
      questions:
      - How do I push my landing page draft edits to the live page?
      - Once a landing page draft looks right, what makes those edits go live?
      instructions:
      - text: Push the draft of landing page {objectId} live.
        slots:
          objectId: path.objectId
      - text: Apply all draft edits on landing page {objectId} to the live version.
        slots:
          objectId: path.objectId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/{objectId}/draft/reset'].post
  update:
    x-apievangelist-phrasing:
      intent: Discard a landing page's draft edits
      effect: destructive
      questions:
      - Can I throw away my landing page draft changes and start over from the live page?
      - Is there a way to reset a landing page draft to match what's published?
      instructions:
      - text: Reset the draft of landing page {objectId} to match the live version.
        slots:
          objectId: path.objectId
      - text: Discard all unpublished draft edits on landing page {objectId}.
        slots:
          objectId: path.objectId
      method: generated
      generated: '2026-09-24'