# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Twilio Voice API version: 1.0.0 extends: openapi/twilio-voice-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: 12 - target: $.paths['/v1/Voice/Settings'].get update: x-apievangelist-phrasing: intent: Check Voice Insights settings effect: read questions: - Is Voice Insights Advanced Features turned on for my account? - Can I see whether Voice Trace is enabled for one of my subaccounts? instructions: - text: Show my current Voice Insights settings. - text: Show the Voice Insights settings for subaccount {subaccount}. slots: subaccount: query.SubaccountSid method: generated generated: '2026-09-26' - target: $.paths['/v1/Voice/Settings'].post update: x-apievangelist-phrasing: intent: Change Voice Insights settings effect: write questions: - How do I switch on Voice Insights Advanced Features? - Can I enable Voice Trace for just one subaccount? instructions: - text: Turn Voice Insights Advanced Features {advanced} for my account. slots: advanced: requestBody.AdvancedFeatures - text: Set Voice Trace to {voice_trace} on subaccount {subaccount}. slots: voice_trace: requestBody.VoiceTrace subaccount: requestBody.SubaccountSid method: generated generated: '2026-09-26' - target: $.paths['/v1/Voice/{CallSid}/Annotation'].get update: x-apievangelist-phrasing: intent: Read the annotation on a call effect: read questions: - What feedback did we record against a particular call, like its score or quality issues? - Was a given call already flagged as spam or tied to an incident? instructions: - text: Show the annotation recorded for call {call}. slots: call: path.CallSid - text: Get the call score and comment we left on call {call}. slots: call: path.CallSid method: generated generated: '2026-09-26' - target: $.paths['/v1/Voice/{CallSid}/Annotation'].post update: x-apievangelist-phrasing: intent: Annotate a call with feedback effect: write questions: - How do I mark a call as spam in Voice Insights? - Can I give a call a 1 to 5 experience score and link it to a support ticket? - Which quality problems can I tag on a call, like echo or choppy audio? instructions: - text: Score call {call} as {score} out of 5. slots: call: path.CallSid score: requestBody.CallScore - text: Flag call {call} as spam. slots: call: path.CallSid - text: Tag call {call} with quality issue {issues} and link it to incident {incident}. slots: call: path.CallSid issues: requestBody.QualityIssues incident: requestBody.Incident method: generated generated: '2026-09-26' - target: $.paths['/v1/Voice/{Sid}'].get update: x-apievangelist-phrasing: intent: Look up a call in Voice Insights effect: read questions: - Can I pull up the Voice Insights record for a single call by its SID? - Where do I find the insights entry point for one specific call? instructions: - text: Fetch the Voice Insights call record {call}. slots: call: path.Sid - text: Open insights call {call} so I can see its links to events and metrics. slots: call: path.Sid method: generated generated: '2026-09-26' - target: $.paths['/v1/Voice/Summaries'].get update: x-apievangelist-phrasing: intent: Search call summaries across my account effect: read questions: - Which of my calls in the last day had dropped-call or echo problems? - Can I filter call summaries by carrier, country or whether SHAKEN/STIR verified the caller? - What calls did answering machine detection mark as a machine this week? instructions: - text: List call summaries from {from} to {to} over the last {start_time}. slots: from: query.From to: query.To start_time: query.StartTime - text: Find calls with call state {state} and direction {direction}. slots: state: query.CallState direction: query.Direction - text: Show every call annotated as spam in subaccount {subaccount}. slots: subaccount: query.Subaccount method: generated generated: '2026-09-26' - target: $.paths['/v1/Voice/{CallSid}/Events'].get update: x-apievangelist-phrasing: intent: List signaling events for a call effect: read questions: - What events happened during a call, step by step? - Can I see only the SIP edge events for a call? instructions: - text: List the insight events for call {call}. slots: call: path.CallSid - text: Show the {edge} events for call {call}. slots: edge: query.Edge call: path.CallSid method: generated generated: '2026-09-26' - target: $.paths['/v1/Voice/{CallSid}/Metrics'].get update: x-apievangelist-phrasing: intent: List quality metrics for a call effect: read questions: - Where do I get jitter and packet loss style metrics for a single call? - Can I split a call's metrics by inbound versus outbound direction? instructions: - text: List the call metrics for call {call}. slots: call: path.CallSid - text: Show {direction} metrics on the {edge} for call {call}. slots: direction: query.Direction edge: query.Edge call: path.CallSid method: generated generated: '2026-09-26' - target: $.paths['/v1/Voice/{CallSid}/Summary'].get update: x-apievangelist-phrasing: intent: Get the summary of one call effect: read questions: - How did a specific call go overall, duration, parties and quality? - Can I get a partial summary for a call that just ended? instructions: - text: Get the call summary for call {call}. slots: call: path.CallSid - text: Include only {processing_state} processing when summarizing call {call}. slots: processing_state: query.ProcessingState call: path.CallSid method: generated generated: '2026-09-26' - target: $.paths['/v2/Voice/Countries'].get update: x-apievangelist-phrasing: intent: List countries with voice pricing effect: read questions: - Which countries have voice calling prices published? - What countries can I look up call rates for? instructions: - text: List all countries with voice pricing. - text: Show the voice pricing country list, {page_size} per page. slots: page_size: query.PageSize method: generated generated: '2026-09-26' - target: $.paths['/v2/Voice/Countries/{IsoCountry}'].get update: x-apievangelist-phrasing: intent: Get voice call prices for a country effect: read questions: - What does it cost to make and receive calls in Germany? - Where can I see inbound and outbound voice rates for one country? instructions: - text: Show voice pricing for country {country}. slots: country: path.IsoCountry - text: Get the per-minute call rates for {country}. slots: country: path.IsoCountry method: generated generated: '2026-09-26' - target: $.paths['/v2/Voice/Numbers/{DestinationNumber}'].get update: x-apievangelist-phrasing: intent: Price a call to a phone number effect: read questions: - How much will it cost to call a specific phone number? - Does the price of a call change depending on which of my numbers I call from? instructions: - text: Get the voice price for calling {destination}. slots: destination: path.DestinationNumber - text: Get the price of calling {destination} from {origination}. slots: destination: path.DestinationNumber origination: query.OriginationNumber method: generated generated: '2026-09-26'