# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for SendPulse CRM Public Contact phone number API
  version: 1.0.0
extends: openapi/sendpulse-contact-phone-number-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: 3
- target: $.paths['/contacts/{contactId}/phones'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a phone number to a CRM contact
      effect: write
      questions:
      - How do I add another phone number to an existing contact?
      - Can I store a second phone on a CRM contact?
      instructions:
      - text: Add phone {phone} to contact {contactId}.
        slots:
          phone: requestBody.phone
          contactId: path.contactId
      - text: Save {phone} as an additional number for contact {contactId}.
        slots:
          phone: requestBody.phone
          contactId: path.contactId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{contactId}/phones/{phoneId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a CRM contact's phone number
      effect: write
      questions:
      - How do I fix a wrong phone number saved on a CRM contact?
      - Can I overwrite one of a contact's existing phone entries?
      instructions:
      - text: Change phone {phoneId} of contact {contactId} to {phone}.
        slots:
          phoneId: path.phoneId
          contactId: path.contactId
          phone: requestBody.phone
      - text: Overwrite contact {contactId}'s phone entry {phoneId} with {phone}.
        slots:
          contactId: path.contactId
          phoneId: path.phoneId
          phone: requestBody.phone
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{contactId}/phones/{phoneId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a phone number from a CRM contact
      effect: destructive
      questions:
      - How do I delete an old phone number from a contact?
      - Can I remove just one of a contact's phone entries?
      instructions:
      - text: Delete phone {phoneId} from contact {contactId}.
        slots:
          phoneId: path.phoneId
          contactId: path.contactId
      - text: Remove the phone entry {phoneId} on contact {contactId}.
        slots:
          phoneId: path.phoneId
          contactId: path.contactId
      method: generated
      generated: '2026-10-01'