# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio - Insights Video API
  version: 1.0.0
extends: openapi/twilio-video-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: 4
- target: $.paths['/v1/Video/Rooms/{RoomSid}/Participants/{ParticipantSid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get call-quality analysis for a room participant
      effect: read
      questions:
      - What did the Video Log Analyzer record about one participant's session?
      - Can I troubleshoot a single participant's call quality after the room ended?
      instructions:
      - text: Get the Log Analyzer summary for participant {participant_sid} in room {room_sid}.
        slots:
          participant_sid: path.ParticipantSid
          room_sid: path.RoomSid
      - text: Show diagnostics for participant {participant_sid} from room {room_sid}.
        slots:
          participant_sid: path.ParticipantSid
          room_sid: path.RoomSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Video/Rooms/{RoomSid}/Participants'].get
  update:
    x-apievangelist-phrasing:
      intent: List participant summaries for a room
      effect: read
      questions:
      - Which participants does the Log Analyzer have data for in a given room?
      - Can I compare every participant's session summary for one room?
      instructions:
      - text: List the participant summaries for room {room_sid}.
        slots:
          room_sid: path.RoomSid
      - text: Show Log Analyzer data for everyone who joined room {room_sid}.
        slots:
          room_sid: path.RoomSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Video/Rooms/{RoomSid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get call-quality analysis for a room
      effect: read
      questions:
      - What does the Video Log Analyzer say about how a room performed?
      - Can I pull a post-call summary for a single video room?
      instructions:
      - text: Get the Log Analyzer summary for room {room_sid}.
        slots:
          room_sid: path.RoomSid
      - text: Show the room-level diagnostics for {room_sid}.
        slots:
          room_sid: path.RoomSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Video/Rooms'].get
  update:
    x-apievangelist-phrasing:
      intent: List room summaries from the Log Analyzer
      effect: read
      questions:
      - Which peer-to-peer or group rooms ran in a given time window, according to the Log Analyzer?
      - Can I find room summaries by codec used or by room name?
      instructions:
      - text: List Log Analyzer room summaries of type {room_type}.
        slots:
          room_type: query.RoomType
      - text: List room summaries created between {after} and {before}.
        slots:
          after: query.CreatedAfter
          before: query.CreatedBefore
      - text: Find room summaries for rooms named {room_name} that used codec {codec}.
        slots:
          room_name: query.RoomName
          codec: query.Codec
      method: generated
      generated: '2026-09-26'