# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for AppConnect V3 Account Services API
  version: 1.0.0
extends: openapi/constant-contact-account-services-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['/account/user/privileges'].get
  update:
    x-apievangelist-phrasing:
      intent: Check what my access token is allowed to do
      effect: read
      questions:
      - Which user privileges does my current access token carry?
      - Why am I getting permission errors, and what privileges does my user actually have?
      instructions:
      - text: List the user privileges tied to my access token.
      - text: Show every privilege my logged-in user has, including ones the API doesn't use yet.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/account/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get my account summary details
      effect: read
      questions:
      - What account details can I pull for my Constant Contact login, like organization name and time zone?
      - Can the account summary also include the company logo and physical address?
      instructions:
      - text: Get my account summary.
      - text: Get my account summary with {extra_fields} included.
        slots:
          extra_fields: query.extra_fields
      method: generated
      generated: '2026-10-01'
- target: $.paths['/account/summary'].put
  update:
    x-apievangelist-phrasing:
      intent: Update my account contact details
      effect: write
      questions:
      - Can I change the contact email or phone number on my account?
      - Is it possible to update my organization name and website without resending every field?
      instructions:
      - text: Change my account contact email to {contact_email}.
        slots:
          contact_email: requestBody.contact_email
      - text: Update my organization name to {organization_name} and website to {website}.
        slots:
          organization_name: requestBody.organization_name
          website: requestBody.website
      method: generated
      generated: '2026-10-01'
- target: $.paths['/account/summary/physical_address'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the organization's physical address
      effect: read
      questions:
      - What physical address is shown in the footer of my emails?
      - Where can I see the mailing address my account has on file?
      instructions:
      - text: Show the physical address saved for my organization.
      - text: Fetch the footer address that goes on every email I send.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/account/summary/physical_address'].put
  update:
    x-apievangelist-phrasing:
      intent: Change the organization's existing physical address
      effect: write
      questions:
      - Can I correct the physical address I already set for my account?
      - We moved offices — what do I need to replace the address that appears in my email footer?
      instructions:
      - text: Replace my existing physical address with {address_line1}, {city}, {country_code}.
        slots:
          address_line1: requestBody.address_line1
          city: requestBody.city
          country_code: requestBody.country_code
      - text: Update my saved footer address to postal code {postal_code} in {city}, {country_code}, street {address_line1}.
        slots:
          postal_code: requestBody.postal_code
          city: requestBody.city
          country_code: requestBody.country_code
          address_line1: requestBody.address_line1
      method: generated
      generated: '2026-10-01'
- target: $.paths['/account/summary/physical_address'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a physical address to a new account
      effect: write
      questions:
      - My account has no physical address yet — how do I add the first one so I can send email?
      - Which fields are required when setting the organization address for the first time?
      instructions:
      - text: Add a first physical address of {address_line1}, {city}, {country_code} to my account.
        slots:
          address_line1: requestBody.address_line1
          city: requestBody.city
          country_code: requestBody.country_code
      - text: Set up my account's initial mailing address at {address_line1} in {city}, state {state_code}, {country_code}.
        slots:
          address_line1: requestBody.address_line1
          city: requestBody.city
          state_code: requestBody.state_code
          country_code: requestBody.country_code
      method: generated
      generated: '2026-10-01'
- target: $.paths['/account/emails'].get
  update:
    x-apievangelist-phrasing:
      intent: List the account's sender email addresses
      effect: read
      questions:
      - Which email addresses on my account are confirmed and usable as a from address?
      - Can I filter my account email addresses by role, like the reply-to address?
      instructions:
      - text: List all email addresses on my account.
      - text: Show account email addresses with confirm status {confirm_status}.
        slots:
          confirm_status: query.confirm_status
      - text: Look up whether {email_address} is registered on my account.
        slots:
          email_address: query.email_address
      method: generated
      generated: '2026-10-01'
- target: $.paths['/account/emails'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a new sender email address
      effect: write
      questions:
      - How do I add another email address I can send campaigns from?
      - What happens if I add an account email address that already exists?
      instructions:
      - text: Add {email_address} as a new email address on my account.
        slots:
          email_address: requestBody.email_address
      - text: Register {email_address} so I can confirm it and use it as a sender.
        slots:
          email_address: requestBody.email_address
      method: generated
      generated: '2026-10-01'