# 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 Surveys API
  version: 1.0.0
extends: openapi/mailchimp-surveys-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: 3
- target: $.paths['/lists/{list_id}/surveys/{survey_id}/actions/publish'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish a survey
      effect: write
      questions:
      - How do I publish a draft survey so people can respond?
      - Can I republish a survey after editing it?
      instructions:
      - text: Publish survey {survey_id} on audience {list_id}.
        slots:
          survey_id: path.survey_id
          list_id: path.list_id
      - text: Make survey {survey_id} for list {list_id} live.
        slots:
          survey_id: path.survey_id
          list_id: path.list_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lists/{list_id}/surveys/{survey_id}/actions/unpublish'].post
  update:
    x-apievangelist-phrasing:
      intent: Unpublish a survey
      effect: write
      questions:
      - How do I take a published survey offline?
      - Can I stop accepting responses to a survey?
      instructions:
      - text: Unpublish survey {survey_id} on audience {list_id}.
        slots:
          survey_id: path.survey_id
          list_id: path.list_id
      - text: Take survey {survey_id} for list {list_id} offline.
        slots:
          survey_id: path.survey_id
          list_id: path.list_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lists/{list_id}/surveys/{survey_id}/actions/create-email'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a campaign that links to a survey
      effect: write
      questions:
      - How do I create an email campaign that sends people to my survey?
      - Can I generate a survey invitation campaign automatically?
      instructions:
      - text: Create a campaign linking to survey {survey_id} for audience {list_id}.
        slots:
          survey_id: path.survey_id
          list_id: path.list_id
      - text: Build an email that invites list {list_id} to take survey {survey_id}.
        slots:
          list_id: path.list_id
          survey_id: path.survey_id
      method: generated
      generated: '2026-09-26'