# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio Messaging Messaging Services API
  version: 1.0.0
extends: openapi/twilio-messaging-services-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: 5
- target: $.paths['/Services'].get
  update:
    x-apievangelist-phrasing:
      intent: List messaging services
      effect: read
      questions:
      - Which messaging services exist on my account?
      - Can I see all my messaging services and their settings in one list?
      instructions:
      - text: List my messaging services.
      - text: Show my messaging services, {page_size} per page.
        slots:
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Services'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a messaging service
      effect: write
      questions:
      - How do I set up a messaging service to manage a pool of senders?
      - Can a new messaging service keep the same sender for each recipient and match local area codes?
      instructions:
      - text: Create a messaging service called {friendly_name}.
        slots:
          friendly_name: requestBody.FriendlyName
      - text: Create messaging service {friendly_name} that sends inbound messages to {inbound_url}.
        slots:
          friendly_name: requestBody.FriendlyName
          inbound_url: requestBody.InboundRequestUrl
      - text: Create messaging service {friendly_name} with sticky sender {sticky} and a validity period of {validity} seconds.
        slots:
          friendly_name: requestBody.FriendlyName
          sticky: requestBody.StickySender
          validity: requestBody.ValidityPeriod
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Services/{ServiceSid}'].get
  update:
    x-apievangelist-phrasing:
      intent: View a messaging service
      effect: read
      questions:
      - What webhooks and sender settings does a given messaging service use?
      - Can I look up one messaging service by its SID?
      instructions:
      - text: Fetch messaging service {service_sid}.
        slots:
          service_sid: path.ServiceSid
      - text: Show the configuration of messaging service {service_sid}.
        slots:
          service_sid: path.ServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Services/{ServiceSid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Change a messaging service's settings
      effect: write
      questions:
      - Can I change the inbound webhook or status callback on an existing messaging service?
      - Is it possible to turn on smart encoding for a messaging service I already have?
      instructions:
      - text: Rename messaging service {service_sid} to {friendly_name}.
        slots:
          service_sid: path.ServiceSid
          friendly_name: requestBody.FriendlyName
      - text: Update messaging service {service_sid} ({friendly_name}) to post delivery status to {status_callback}.
        slots:
          service_sid: path.ServiceSid
          friendly_name: requestBody.FriendlyName
          status_callback: requestBody.StatusCallback
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Services/{ServiceSid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a messaging service
      effect: destructive
      questions:
      - Can I remove a messaging service I no longer need?
      - What happens to a messaging service once it's deleted?
      instructions:
      - text: Delete messaging service {service_sid}.
        slots:
          service_sid: path.ServiceSid
      - text: Remove the messaging service {service_sid} from my account.
        slots:
          service_sid: path.ServiceSid
      method: generated
      generated: '2026-09-26'