# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cvent REST Venue Meeting Rooms API
  version: 1.0.0
extends: openapi/cvent-registration-venue-meeting-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: 8
- target: $.paths['/venues/{venueId}/meeting-rooms'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a meeting room to a venue
      effect: write
      questions:
      - How do I add a new meeting room to my venue's profile?
      - What's required when creating a meeting room, like its name and dimensions?
      instructions:
      - text: Create meeting room {name} at venue {venueId} with dimensions {dimensions}.
        slots:
          name: requestBody.name
          venueId: path.venueId
          dimensions: requestBody.dimensions
      - text: Add a new room {name} to venue {venueId} with capacities {capacities}.
        slots:
          name: requestBody.name
          venueId: path.venueId
          capacities: requestBody.capacities
      method: generated
      generated: '2026-09-26'
- target: $.paths['/venues/{venueId}/meeting-rooms/overviews'].get
  update:
    x-apievangelist-phrasing:
      intent: List a venue's meeting rooms
      effect: read
      questions:
      - What meeting rooms does a venue have?
      - Can I filter a venue's meeting room overviews?
      instructions:
      - text: List meeting rooms at venue {venueId}.
        slots:
          venueId: path.venueId
      - text: List venue {venueId} meeting room overviews matching {filter}.
        slots:
          venueId: path.venueId
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/venues/{venueId}/meeting-rooms/{meetingRoomId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a meeting room's details
      effect: write
      questions:
      - Can I overwrite all of a meeting room's data in one go?
      - Does a full meeting room update replace fields I leave out?
      instructions:
      - text: Replace meeting room {meetingRoomId} at venue {venueId} with name {name} and dimensions {dimensions}.
        slots:
          meetingRoomId: path.meetingRoomId
          venueId: path.venueId
          name: requestBody.name
          dimensions: requestBody.dimensions
      - text: Fully overwrite room {meetingRoomId} at venue {venueId}.
        slots:
          meetingRoomId: path.meetingRoomId
          venueId: path.venueId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/venues/{venueId}/meeting-rooms/{meetingRoomId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update a meeting room
      effect: write
      questions:
      - Can I change just one field on a meeting room without resending everything?
      - If I patch a meeting room's amenities, is the list merged or replaced?
      instructions:
      - text: Patch only the description of room {meetingRoomId} at venue {venueId} to {description}.
        slots:
          meetingRoomId: path.meetingRoomId
          venueId: path.venueId
          description: requestBody.description
      - text: Change just the amenities of room {meetingRoomId} (venue {venueId}) to {amenities}.
        slots:
          meetingRoomId: path.meetingRoomId
          venueId: path.venueId
          amenities: requestBody.amenities
      method: generated
      generated: '2026-09-26'
- target: $.paths['/venues/{venueId}/meeting-rooms/{meetingRoomId}/images'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a meeting room's image
      effect: read
      questions:
      - Does a meeting room have a photo attached?
      - Which image ID is attached to a meeting room?
      instructions:
      - text: List images for meeting room {meetingRoomId} at venue {venueId}.
        slots:
          meetingRoomId: path.meetingRoomId
          venueId: path.venueId
      - text: Show the photo on room {meetingRoomId} at venue {venueId}.
        slots:
          meetingRoomId: path.meetingRoomId
          venueId: path.venueId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/venues/{venueId}/meeting-rooms/{meetingRoomId}/images'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a meeting room's image
      effect: write
      questions:
      - How do I attach an uploaded JPEG to a meeting room?
      - What image size is recommended for a meeting room photo?
      instructions:
      - text: Set uploaded file {file} as the image of room {meetingRoomId} at venue {venueId}.
        slots:
          file: requestBody.file
          meetingRoomId: path.meetingRoomId
          venueId: path.venueId
      - text: Replace the photo on meeting room {meetingRoomId} (venue {venueId}) with file {file}.
        slots:
          meetingRoomId: path.meetingRoomId
          venueId: path.venueId
          file: requestBody.file
      method: generated
      generated: '2026-09-26'
- target: $.paths['/venues/{venueId}/meeting-rooms/{meetingRoomId}/images/{imageId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a meeting room's image
      effect: destructive
      questions:
      - How do I take the photo off a meeting room?
      - Can I remove a meeting room image without uploading a replacement?
      instructions:
      - text: Remove image {imageId} from room {meetingRoomId} at venue {venueId}.
        slots:
          imageId: path.imageId
          meetingRoomId: path.meetingRoomId
          venueId: path.venueId
      - text: Detach photo {imageId} from meeting room {meetingRoomId} (venue {venueId}).
        slots:
          imageId: path.imageId
          meetingRoomId: path.meetingRoomId
          venueId: path.venueId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/venues/{venueId}/meeting-rooms/{meetingRoomId}/overview'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one meeting room's overview
      effect: read
      questions:
      - What are the dimensions, capacities and amenities of a specific meeting room?
      - Can I look up one room's overview at a venue?
      instructions:
      - text: Get the overview of room {meetingRoomId} at venue {venueId}.
        slots:
          meetingRoomId: path.meetingRoomId
          venueId: path.venueId
      - text: Show capacities and amenities for meeting room {meetingRoomId} (venue {venueId}).
        slots:
          meetingRoomId: path.meetingRoomId
          venueId: path.venueId
      method: generated
      generated: '2026-09-26'