# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mailchimp Transactional Subaccounts API
  version: 1.0.0
extends: openapi/mailchimp-subaccounts-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['/subaccounts/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List transactional subaccounts
      effect: read
      questions:
      - What subaccounts exist on my transactional email account?
      - Can I find subaccounts whose IDs start with a certain prefix?
      instructions:
      - text: List all my transactional subaccounts.
      - text: Show subaccounts whose ID starts with {q}.
        slots:
          q: requestBody.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subaccounts/add'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a subaccount
      effect: write
      questions:
      - How do I set up a separate subaccount for one of my customers?
      - Can I give a new subaccount its own hourly sending quota?
      instructions:
      - text: Create subaccount {id} named {name}.
        slots:
          id: requestBody.id
          name: requestBody.name
      - text: Add a new subaccount {id} with a custom quota of {custom_quota}.
        slots:
          id: requestBody.id
          custom_quota: requestBody.custom_quota
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subaccounts/info'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a subaccount's details
      effect: read
      questions:
      - What's the status, reputation and quota of one subaccount?
      - Can I look up a single subaccount by its ID?
      instructions:
      - text: Get the details of subaccount {id}.
        slots:
          id: requestBody.id
      - text: Show the sending stats and status of subaccount {id}.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subaccounts/update'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a subaccount
      effect: write
      questions:
      - Can I rename an existing subaccount or change its notes?
      - How do I raise the custom quota on a subaccount that already exists?
      instructions:
      - text: Rename subaccount {id} to {name}.
        slots:
          id: requestBody.id
          name: requestBody.name
      - text: Change the custom quota of existing subaccount {id} to {custom_quota}.
        slots:
          id: requestBody.id
          custom_quota: requestBody.custom_quota
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subaccounts/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a subaccount
      effect: destructive
      questions:
      - What happens to a subaccount's email and stats if I delete it?
      - Can I permanently remove a subaccount so it can no longer send?
      instructions:
      - text: Delete subaccount {id}.
        slots:
          id: requestBody.id
      - text: Remove subaccount {id} permanently so future sends fail.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subaccounts/pause'].post
  update:
    x-apievangelist-phrasing:
      intent: Pause a subaccount's sending
      effect: write
      questions:
      - Can I temporarily stop one subaccount from sending email?
      - How long are emails queued while a subaccount is paused?
      instructions:
      - text: Pause sending for subaccount {id}.
        slots:
          id: requestBody.id
      - text: Hold all outgoing mail from subaccount {id} for now.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subaccounts/resume'].post
  update:
    x-apievangelist-phrasing:
      intent: Resume a paused subaccount
      effect: write
      questions:
      - How do I restart sending on a subaccount I paused?
      - Will queued emails go out once a paused subaccount is resumed?
      instructions:
      - text: Resume sending for subaccount {id}.
        slots:
          id: requestBody.id
      - text: Unpause subaccount {id} so its queued email goes out.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-26'