# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Azure Communication Room Service Rooms API
  version: 1.0.0
extends: openapi/microsoft-azure-rooms-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['/rooms'].get
  update:
    x-apievangelist-phrasing:
      intent: List all rooms
      effect: read
      questions:
      - Where can I see every room I've created for calls?
      - Can I list all existing Communication Services rooms?
      instructions:
      - text: List all my rooms.
      - text: List all rooms using API version {api_version}.
        slots:
          api_version: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rooms'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a room
      effect: write
      questions:
      - How do I create a room for a scheduled call?
      - Can I set when a room opens and closes for joining?
      - Is it possible to enable PSTN dial-out in a new room?
      instructions:
      - text: Create a room open from {validFrom} until {validUntil}.
        slots:
          validFrom: requestBody.validFrom
          validUntil: requestBody.validUntil
      - text: Create a room with participants {participants} and dial-out enabled {pstnDialOutEnabled}.
        slots:
          participants: requestBody.participants
          pstnDialOutEnabled: requestBody.pstnDialOutEnabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rooms/{roomId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a room by ID
      effect: read
      questions:
      - What validity window does a particular room have?
      - Is PSTN dial-out turned on for a particular room?
      instructions:
      - text: Get room {roomId}.
        slots:
          roomId: path.roomId
      - text: Show the validity window and participants settings of room {roomId}.
        slots:
          roomId: path.roomId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rooms/{roomId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a room
      effect: destructive
      questions:
      - Can I delete a room that's no longer needed?
      - Can I cancel a room so nobody can join it?
      instructions:
      - text: Delete room {roomId}.
        slots:
          roomId: path.roomId
      - text: Remove room {roomId} so no one can join it.
        slots:
          roomId: path.roomId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rooms/{roomId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a room's schedule or dial-out
      effect: write
      questions:
      - How do I extend the end time of an existing room?
      - Can I turn PSTN dial-out on or off for a room after creating it?
      instructions:
      - text: Change room {roomId} to be valid until {validUntil}.
        slots:
          roomId: path.roomId
          validUntil: requestBody.validUntil
      - text: Set PSTN dial-out on room {roomId} to {pstnDialOutEnabled}.
        slots:
          roomId: path.roomId
          pstnDialOutEnabled: requestBody.pstnDialOutEnabled
      method: generated
      generated: '2026-09-26'