# 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 Connected Sites API
  version: 1.0.0
extends: openapi/mailchimp-connectedsites-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/connected-sites'].get
  update:
    x-apievangelist-phrasing:
      intent: List connected websites
      effect: read
      questions:
      - Which websites have I connected to my Mailchimp account?
      - Can I see all my connected sites and their tracking script details?
      instructions:
      - text: List all my connected sites.
      - text: Show {count} connected sites.
        slots:
          count: query.count
      method: generated
      generated: '2026-09-26'
- target: $.paths['/connected-sites'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect a new website
      effect: write
      questions:
      - How do I connect my website so I can track visitors and add pop-up forms?
      - What do I need to register a new connected site?
      instructions:
      - text: Connect site {domain} with foreign id {foreign_id}.
        slots:
          domain: requestBody.domain
          foreign_id: requestBody.foreign_id
      - text: Add a connected site for domain {domain} using identifier {foreign_id}.
        slots:
          domain: requestBody.domain
          foreign_id: requestBody.foreign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/connected-sites/{connected_site_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one connected site
      effect: read
      questions:
      - What's the tracking script URL for a specific connected site?
      - Can I look up one connected site's details by ID?
      instructions:
      - text: Show connected site {connected_site_id}.
        slots:
          connected_site_id: path.connected_site_id
      - text: Get the site script for connected site {connected_site_id}.
        slots:
          connected_site_id: path.connected_site_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/connected-sites/{connected_site_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a connected site
      effect: destructive
      questions:
      - Can I disconnect a website from my Mailchimp account?
      - What's the call to remove a connected site I no longer run?
      instructions:
      - text: Delete connected site {connected_site_id}.
        slots:
          connected_site_id: path.connected_site_id
      - text: Disconnect site {connected_site_id} from my account.
        slots:
          connected_site_id: path.connected_site_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/connected-sites/{connected_site_id}/actions/verify-script-installation'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a connected site's script is installed
      effect: read
      questions:
      - Is the Mailchimp tracking script actually installed on my website?
      - Can I confirm the connected site snippet was added correctly?
      instructions:
      - text: Verify the script installation on connected site {connected_site_id}.
        slots:
          connected_site_id: path.connected_site_id
      - text: Check whether site {connected_site_id} has the connected-site script in place.
        slots:
          connected_site_id: path.connected_site_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/connected-sites/{connected_site_id}/actions/enable-pixel'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn on the tracking pixel for a site
      effect: write
      questions:
      - How do I enable the Mailchimp tracking pixel on a connected site?
      - Can I start pixel tracking for a website I've already connected?
      instructions:
      - text: Enable the tracking pixel for connected site {connected_site_id}.
        slots:
          connected_site_id: path.connected_site_id
      - text: Turn on pixel tracking for site {connected_site_id}.
        slots:
          connected_site_id: path.connected_site_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/connected-sites/{connected_site_id}/actions/disable-pixel'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn off the tracking pixel for a site
      effect: write
      questions:
      - Can I stop the Mailchimp pixel from tracking visitors on one of my sites?
      - What's the way to disable pixel tracking for a connected site?
      instructions:
      - text: Disable the tracking pixel for connected site {connected_site_id}.
        slots:
          connected_site_id: path.connected_site_id
      - text: Turn off pixel tracking on site {connected_site_id}.
        slots:
          connected_site_id: path.connected_site_id
      method: generated
      generated: '2026-09-26'