# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mailchimp Marketing Landing Pages API
  version: 1.0.0
extends: openapi/mailchimp-landing-pages-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: 8
- target: $.paths['/landing-pages'].get
  update:
    x-apievangelist-phrasing:
      intent: List landing pages
      effect: read
      questions:
      - What landing pages have I built?
      - Can I sort my landing pages by when they were created?
      instructions:
      - text: List all my landing pages.
      - text: Show my first {count} landing pages.
        slots:
          count: query.count
      method: generated
      generated: '2026-10-01'
- target: $.paths['/landing-pages'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a landing page
      effect: write
      questions:
      - How do I create a new landing page from a template?
      - Can a new landing page collect signups into a specific audience?
      instructions:
      - text: Create a landing page called {name} using template {template_id}.
        slots:
          name: requestBody.name
          template_id: requestBody.template_id
      - text: Create a new signup landing page {name} that feeds audience {list_id}.
        slots:
          name: requestBody.name
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/landing-pages/{page_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one landing page
      effect: read
      questions:
      - Is a specific landing page published, and what's its URL?
      - Can I look up one landing page's settings by ID?
      instructions:
      - text: Get landing page {page_id}.
        slots:
          page_id: path.page_id
      - text: Show the status and URL of landing page {page_id}.
        slots:
          page_id: path.page_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/landing-pages/{page_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a landing page
      effect: destructive
      questions:
      - Can I permanently delete a landing page?
      - What's the way to get rid of an old landing page entirely?
      instructions:
      - text: Delete landing page {page_id}.
        slots:
          page_id: path.page_id
      - text: Remove landing page {page_id} for good.
        slots:
          page_id: path.page_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/landing-pages/{page_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a landing page's settings
      effect: write
      questions:
      - How do I change a landing page's title or description?
      - Can I switch which audience an existing landing page collects signups into?
      instructions:
      - text: Change the title of landing page {page_id} to {title}.
        slots:
          page_id: path.page_id
          title: requestBody.title
      - text: Point existing landing page {page_id} at audience {list_id}.
        slots:
          page_id: path.page_id
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/landing-pages/{page_id}/actions/publish'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish a landing page
      effect: write
      questions:
      - How do I make a draft landing page live?
      - Do I need to republish a landing page after editing it?
      instructions:
      - text: Publish landing page {page_id}.
        slots:
          page_id: path.page_id
      - text: Make landing page {page_id} live with its latest edits.
        slots:
          page_id: path.page_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/landing-pages/{page_id}/actions/unpublish'].post
  update:
    x-apievangelist-phrasing:
      intent: Unpublish a landing page
      effect: write
      questions:
      - Can I take a landing page offline without deleting it?
      - How do I hide a published landing page temporarily?
      instructions:
      - text: Unpublish landing page {page_id}.
        slots:
          page_id: path.page_id
      - text: Take landing page {page_id} offline but keep it.
        slots:
          page_id: path.page_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/landing-pages/{page_id}/content'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a landing page's HTML
      effect: read
      questions:
      - Can I download the HTML behind one of my landing pages?
      - What markup does a landing page actually render?
      instructions:
      - text: Get the HTML content of landing page {page_id}.
        slots:
          page_id: path.page_id
      - text: Export the page markup for landing page {page_id}.
        slots:
          page_id: path.page_id
      method: generated
      generated: '2026-10-01'