API Evangelist conversational phrasing for Twilio Services API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio Services API
  version: 1.0.0
extends: openapi/twilio-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: 265
- target: $.paths['/v1/Services'].get
  update:
    x-apievangelist-phrasing:
      intent: List Conversations services (v1)
      effect: read
      questions:
      - Which conversation services are set up on my account under the v1 Services endpoint?
      - Can I list every Conversations service I have created?
      instructions:
      - text: List my Conversations services via /v1/Services.
      - text: Show all conversation services on the account from the v1 endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Conversations service (v1)
      effect: write
      questions:
      - Can I create a separate conversation service to isolate one app's data?
      - What does it take to spin up a new v1 conversation service?
      instructions:
      - text: Create a v1 conversation service called {name}.
        slots:
          name: requestBody.FriendlyName
      - text: Set up a new Conversations service named {name} through /v1/Services.
        slots:
          name: requestBody.FriendlyName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Conversations service (v1)
      effect: read
      questions:
      - Can I look up one conversation service by its SID on the v1 endpoint?
      - What is the friendly name of a given v1 conversation service?
      instructions:
      - text: Fetch v1 conversation service {service}.
        slots:
          service: path.Sid
      - text: Show the details of Conversations service {service} from /v1/Services.
        slots:
          service: path.Sid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a v1 service's messaging settings
      effect: write
      questions:
      - Can I turn on Sticky Sender or Smart Encoding on a v1 service?
      - Is it possible to change the inbound request URL and status callback of a v1 service?
      instructions:
      - text: Enable sticky sender and smart encoding on v1 service {service}.
        slots:
          service: path.Sid
      - text: Send inbound messages for v1 service {service} to {inbound_url} and status updates to {status_callback}.
        slots:
          service: path.Sid
          inbound_url: requestBody.InboundRequestUrl
          status_callback: requestBody.StatusCallback
      - text: Set the message validity period of v1 service {service} to {validity_period} seconds.
        slots:
          service: path.Sid
          validity_period: requestBody.ValidityPeriod
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Conversations service (v1)
      effect: destructive
      questions:
      - Can I delete a conversation service together with all its conversations and users?
      - Does removing a v1 conversation service wipe its nested resources?
      instructions:
      - text: Delete v1 conversation service {service} and everything nested in it.
        slots:
          service: path.Sid
      - text: Remove Conversations service {service} via /v1/Services.
        slots:
          service: path.Sid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Bindings/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a push binding in a Conversations service
      effect: read
      questions:
      - Can I look up one device push registration in my Conversations service?
      - Which identity does a given Conversations push binding belong to?
      instructions:
      - text: Fetch push binding {binding} in Conversations service {service}.
        slots:
          binding: path.Sid
          service: path.ChatServiceSid
      - text: Show the device token details of Conversations binding {binding} under {service}.
        slots:
          binding: path.Sid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Bindings/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a push binding from a Conversations service
      effect: destructive
      questions:
      - How can I stop push notifications reaching a device that left my Conversations app?
      - Can I unregister one device from Conversations push notifications?
      instructions:
      - text: Delete Conversations push binding {binding} from service {service}.
        slots:
          binding: path.Sid
          service: path.ChatServiceSid
      - text: Unregister device binding {binding} so Conversations service {service} stops pushing to it.
        slots:
          binding: path.Sid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Bindings'].get
  update:
    x-apievangelist-phrasing:
      intent: List push bindings in a Conversations service
      effect: read
      questions:
      - Which devices are registered for push in my Conversations service?
      - Can I filter Conversations push bindings by user identity or by APN vs FCM?
      instructions:
      - text: List push bindings in Conversations service {service}.
        slots:
          service: path.ChatServiceSid
      - text: List the Conversations push bindings for identity {identity} in service {service}.
        slots:
          identity: query.Identity
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Configuration'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Conversations service's configuration
      effect: read
      questions:
      - What default roles does my Conversations service assign to new users?
      - Is reachability turned on for a Conversations service?
      instructions:
      - text: Show the configuration of Conversations service {service}.
        slots:
          service: path.ChatServiceSid
      - text: Fetch the default role settings for Conversations service {service}.
        slots:
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Configuration'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a Conversations service's configuration
      effect: write
      questions:
      - Can I change which role a user gets when they create a conversation?
      - Is it possible to enable the reachability indicator for a Conversations service?
      instructions:
      - text: Enable reachability indicators on Conversations service {service}.
        slots:
          service: path.ChatServiceSid
      - text: Set the default conversation creator role of service {service} to {role}.
        slots:
          service: path.ChatServiceSid
          role: requestBody.DefaultConversationCreatorRoleSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations'].get
  update:
    x-apievangelist-phrasing:
      intent: List conversations in a Conversations service
      effect: read
      questions:
      - Which conversations exist in one of my Conversations services?
      - Can I list only active or closed conversations between two dates?
      instructions:
      - text: List conversations in service {service}.
        slots:
          service: path.ChatServiceSid
      - text: List {state} conversations in service {service} created since {start_date}.
        slots:
          state: query.State
          service: path.ChatServiceSid
          start_date: query.StartDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a conversation in a Conversations service
      effect: write
      questions:
      - Can I open a new conversation inside a specific Conversations service?
      - Is it possible to set a timer so a new conversation closes itself after inactivity?
      instructions:
      - text: Create a conversation called {name} in service {service}.
        slots:
          name: requestBody.FriendlyName
          service: path.ChatServiceSid
      - text: Start a conversation with unique name {unique_name} in service {service} that goes inactive after {inactive_timer}.
        slots:
          unique_name: requestBody.UniqueName
          service: path.ChatServiceSid
          inactive_timer: requestBody.Timers.Inactive
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a conversation in a Conversations service
      effect: read
      questions:
      - What state is a particular conversation in right now?
      - Can I see the attributes and timers stored on one conversation?
      instructions:
      - text: Fetch conversation {conversation} from service {service}.
        slots:
          conversation: path.Sid
          service: path.ChatServiceSid
      - text: Show me the details of conversation {conversation} in {service}.
        slots:
          conversation: path.Sid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a conversation in a Conversations service
      effect: write
      questions:
      - Can I close a conversation or rename it after it has started?
      - Is there a way to change the messaging service a conversation uses?
      instructions:
      - text: Rename conversation {conversation} in service {service} to {name}.
        slots:
          conversation: path.Sid
          service: path.ChatServiceSid
          name: requestBody.FriendlyName
      - text: Set conversation {conversation} in {service} to state {state}.
        slots:
          conversation: path.Sid
          service: path.ChatServiceSid
          state: requestBody.State
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a conversation from a Conversations service
      effect: destructive
      questions:
      - Can I permanently remove a conversation and its history from a service?
      - Is it possible to delete a conversation without firing webhooks?
      instructions:
      - text: Delete conversation {conversation} from service {service}.
        slots:
          conversation: path.Sid
          service: path.ChatServiceSid
      - text: Remove conversation {conversation} in {service} with webhooks set to {webhook_enabled}.
        slots:
          conversation: path.Sid
          service: path.ChatServiceSid
          webhook_enabled: header.X-Twilio-Webhook-Enabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages'].get
  update:
    x-apievangelist-phrasing:
      intent: List messages in a conversation
      effect: read
      questions:
      - Can I pull the message history of one conversation?
      - Is it possible to read a conversation's messages newest first?
      instructions:
      - text: List the messages in conversation {conversation} of service {service}.
        slots:
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Read conversation {conversation} in {service} in {order} order.
        slots:
          conversation: path.ConversationSid
          service: path.ChatServiceSid
          order: query.Order
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a message into a conversation
      effect: write
      questions:
      - Can I post a message into a conversation on behalf of a specific author?
      - Is it possible to send a rich content template into a conversation?
      instructions:
      - text: Send {body} to conversation {conversation} in service {service}.
        slots:
          body: requestBody.Body
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Post a message as {author} saying {body} in conversation {conversation} of {service}.
        slots:
          author: requestBody.Author
          body: requestBody.Body
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one message from a conversation
      effect: read
      questions:
      - Can I retrieve a single conversation message by its ID?
      - Who wrote a particular message in a conversation, and what media did it carry?
      instructions:
      - text: Fetch message {message} from conversation {conversation} in service {service}.
        slots:
          message: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Show the author and body of conversation message {message} ({conversation}, {service}).
        slots:
          message: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Edit a message in a conversation
      effect: write
      questions:
      - Can I edit the text of a message that was already posted to a conversation?
      - Is it possible to change the attributes stored on a conversation message?
      instructions:
      - text: Change the body of message {message} in conversation {conversation} ({service}) to {body}.
        slots:
          message: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
          body: requestBody.Body
      - text: Update the attributes of conversation message {message} in {conversation} under {service}.
        slots:
          message: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a message from a conversation
      effect: destructive
      questions:
      - Can I remove an inappropriate message from a conversation?
      - Does deleting a conversation message remove it for every participant?
      instructions:
      - text: Delete message {message} from conversation {conversation} in service {service}.
        slots:
          message: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Remove the conversation message {message} posted in {conversation} ({service}).
        slots:
          message: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages/{MessageSid}/Receipts/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a delivery receipt for a conversation message
      effect: read
      questions:
      - Was a specific conversation message delivered or read by one recipient?
      - Can I look up a single read receipt for a message?
      instructions:
      - text: Fetch receipt {receipt} for message {message} in conversation {conversation} ({service}).
        slots:
          receipt: path.Sid
          message: path.MessageSid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Show delivery status of receipt {receipt} on message {message} ({conversation}, {service}).
        slots:
          receipt: path.Sid
          message: path.MessageSid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages/{MessageSid}/Receipts'].get
  update:
    x-apievangelist-phrasing:
      intent: List delivery receipts for a conversation message
      effect: read
      questions:
      - Who has received or read a message I sent in a conversation?
      - Can I see every delivery and read receipt for one conversation message?
      instructions:
      - text: List all receipts for message {message} in conversation {conversation} of service {service}.
        slots:
          message: path.MessageSid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Show who read message {message} in {conversation} ({service}).
        slots:
          message: path.MessageSid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Participants'].get
  update:
    x-apievangelist-phrasing:
      intent: List participants in a conversation
      effect: read
      questions:
      - Who is taking part in a given conversation?
      - Can I list the SMS and chat participants of one conversation?
      instructions:
      - text: List participants of conversation {conversation} in service {service}.
        slots:
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Show everyone in conversation {conversation} under {service}.
        slots:
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Participants'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a participant to a conversation
      effect: write
      questions:
      - Can I add an SMS user to a conversation by their phone number?
      - Is it possible to add a chat user by identity and give them a role?
      instructions:
      - text: Add chat user {identity} to conversation {conversation} in service {service}.
        slots:
          identity: requestBody.Identity
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Add phone {address} to conversation {conversation} ({service}) via my number {proxy_address}.
        slots:
          address: requestBody.MessagingBinding.Address
          conversation: path.ConversationSid
          service: path.ChatServiceSid
          proxy_address: requestBody.MessagingBinding.ProxyAddress
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Participants/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a participant in a conversation
      effect: read
      questions:
      - Can I look up one participant's details in a conversation?
      - What was the last message a given participant read?
      instructions:
      - text: Fetch participant {participant} of conversation {conversation} in service {service}.
        slots:
          participant: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Show the read horizon of participant {participant} in {conversation} ({service}).
        slots:
          participant: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Participants/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a participant in a conversation
      effect: write
      questions:
      - Can I change a participant's role inside a conversation?
      - Is it possible to mark messages as read up to an index for one participant?
      instructions:
      - text: Give participant {participant} in conversation {conversation} ({service}) the role {role}.
        slots:
          participant: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
          role: requestBody.RoleSid
      - text: Set the last read message index of participant {participant} in {conversation} ({service}) to {index}.
        slots:
          participant: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
          index: requestBody.LastReadMessageIndex
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Participants/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a participant from a conversation
      effect: destructive
      questions:
      - Can I kick someone out of a conversation?
      - What happens to a participant's access when I remove them from a conversation?
      instructions:
      - text: Remove participant {participant} from conversation {conversation} in service {service}.
        slots:
          participant: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Kick {participant} out of conversation {conversation} ({service}).
        slots:
          participant: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Webhooks'].get
  update:
    x-apievangelist-phrasing:
      intent: List webhooks on one conversation
      effect: read
      questions:
      - Which webhooks are attached to a single conversation rather than the whole service?
      - Can I see whether a conversation is wired to a Studio flow?
      instructions:
      - text: List the webhooks scoped to conversation {conversation} in service {service}.
        slots:
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Show conversation-level webhook targets for {conversation} ({service}).
        slots:
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Webhooks'].post
  update:
    x-apievangelist-phrasing:
      intent: Attach a webhook to one conversation
      effect: write
      questions:
      - Can I send events from just one conversation to my own URL?
      - Is it possible to trigger a webhook only when certain keywords appear in a conversation?
      instructions:
      - text: Add a {target} webhook to conversation {conversation} in service {service}.
        slots:
          target: requestBody.Target
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Hook conversation {conversation} ({service}) to {url} with target {target}.
        slots:
          conversation: path.ConversationSid
          service: path.ChatServiceSid
          url: requestBody.Configuration.Url
          target: requestBody.Target
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Webhooks/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a webhook attached to a conversation
      effect: read
      questions:
      - What URL and filters does a conversation-scoped webhook use?
      - Can I inspect one webhook configured on a conversation?
      instructions:
      - text: Fetch webhook {webhook} on conversation {conversation} in service {service}.
        slots:
          webhook: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Show the triggers and filters of conversation webhook {webhook} ({conversation}, {service}).
        slots:
          webhook: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Webhooks/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a webhook attached to a conversation
      effect: write
      questions:
      - Can I change the URL an existing conversation webhook posts to?
      - Is it possible to change which events fire a webhook on one conversation?
      instructions:
      - text: Point conversation webhook {webhook} on {conversation} ({service}) at {url}.
        slots:
          webhook: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
          url: requestBody.Configuration.Url
      - text: Change the event filters of webhook {webhook} in conversation {conversation} under {service} to {filters}.
        slots:
          webhook: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
          filters: requestBody.Configuration.Filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Webhooks/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a webhook from a conversation
      effect: destructive
      questions:
      - Can I stop one conversation from sending events to my webhook?
      - Is it possible to detach a Studio flow webhook from a conversation?
      instructions:
      - text: Delete webhook {webhook} from conversation {conversation} in service {service}.
        slots:
          webhook: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      - text: Detach conversation webhook {webhook} ({conversation}, {service}).
        slots:
          webhook: path.Sid
          conversation: path.ConversationSid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Configuration/Notifications'].get
  update:
    x-apievangelist-phrasing:
      intent: Get push notification settings of a Conversations service
      effect: read
      questions:
      - Are new-message push notifications turned on for my Conversations service?
      - What sound and template does a Conversations service use for push alerts?
      instructions:
      - text: Show the push notification settings of Conversations service {service}.
        slots:
          service: path.ChatServiceSid
      - text: Fetch the notification templates configured for {service}.
        slots:
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Configuration/Notifications'].post
  update:
    x-apievangelist-phrasing:
      intent: Change push notification settings of a Conversations service
      effect: write
      questions:
      - Can I send a push notification whenever someone is added to a conversation?
      - Is it possible to customize the push text shown for new messages?
      instructions:
      - text: Turn on new-message push notifications for Conversations service {service}.
        slots:
          service: path.ChatServiceSid
      - text: Set the new-message push template for {service} to {template}.
        slots:
          service: path.ChatServiceSid
          template: requestBody.NewMessage.Template
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/ParticipantConversations'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the conversations a participant is in
      effect: read
      questions:
      - Which conversations is a given user or phone number part of?
      - Can I look up conversations by a participant's SMS address instead of identity?
      instructions:
      - text: List conversations that identity {identity} belongs to in service {service}.
        slots:
          identity: query.Identity
          service: path.ChatServiceSid
      - text: Find every conversation in {service} that phone address {address} participates in.
        slots:
          service: path.ChatServiceSid
          address: query.Address
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List roles in a Conversations service
      effect: read
      questions:
      - What user roles are defined in my Conversations service?
      - Can I see the permissions each Conversations role grants?
      instructions:
      - text: List roles in Conversations service {service}.
        slots:
          service: path.ChatServiceSid
      - text: Show all Conversations roles and their permissions for {service}.
        slots:
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a role in a Conversations service
      effect: write
      questions:
      - Can I create a custom role that only lets users send messages?
      - Is it possible to define a service-level versus conversation-level role?
      instructions:
      - text: Create a {type} role called {name} with permission {permission} in Conversations service {service}.
        slots:
          type: requestBody.Type
          name: requestBody.FriendlyName
          permission: requestBody.Permission
          service: path.ChatServiceSid
      - text: Add a Conversations role {name} to {service} granting {permission}, of type {type}.
        slots:
          name: requestBody.FriendlyName
          service: path.ChatServiceSid
          permission: requestBody.Permission
          type: requestBody.Type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Services/{ChatServiceSid}/Roles/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a role in a Conversations service
      effect: read
      questions:
      - What permissions does a specific Conversations role have?
      - Can I look up one role by its SID in a Conversations service?
      instructions:
      - text: Fetch Conversations role {role} from service {service}.
        slots:
          role: path.Sid
          service: path.ChatServiceSid
      - text: Show what Conversations role {role} in {service} is allowed to do.
        slots:
          role: path.Sid
          service: path.ChatServiceSid
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (204 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/overlays/twilio-services-api-phrasing-overlay.yaml