# 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 Travel Suppliers API
  version: 1.0.0
extends: openapi/cvent-event-cloud-travel-suppliers-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['/travel-suppliers/brands'].get
  update:
    x-apievangelist-phrasing:
      intent: List hotel supplier brands
      effect: read
      questions:
      - What hotel brands are in the travel supplier directory?
      - Can I filter supplier brands by name?
      instructions:
      - text: List travel supplier brands.
      - text: List supplier brands matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-suppliers/brands/{brandId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a supplier brand
      effect: read
      questions:
      - Can I look up a hotel brand by its brand code?
      - Which chain does a given supplier brand belong to?
      instructions:
      - text: Get supplier brand {brandId}.
        slots:
          brandId: path.brandId
      - text: Show details for brand code {brandId}.
        slots:
          brandId: path.brandId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-suppliers/chains'].get
  update:
    x-apievangelist-phrasing:
      intent: List hotel supplier chains
      effect: read
      questions:
      - Which hotel chains are available as travel suppliers?
      - Can I filter the supplier chains list?
      instructions:
      - text: List travel supplier chains.
      - text: List supplier chains matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-suppliers/chains/{chainId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a supplier chain
      effect: read
      questions:
      - Can I get the details of one hotel chain by ID?
      - What information does the directory hold on a particular chain?
      instructions:
      - text: Get supplier chain {chainId}.
        slots:
          chainId: path.chainId
      - text: Show hotel chain {chainId}.
        slots:
          chainId: path.chainId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-suppliers/properties'].get
  update:
    x-apievangelist-phrasing:
      intent: List supplier hotel properties
      effect: read
      questions:
      - Which hotel properties can I find in the supplier directory?
      - Can I filter supplier properties, say by city?
      instructions:
      - text: List supplier properties.
      - text: List hotel properties matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-suppliers/properties/{propertyId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a supplier property
      effect: read
      questions:
      - Can I pull the details of one hotel property by its ID?
      - What does the directory say about a specific supplier property?
      instructions:
      - text: Get supplier property {propertyId}.
        slots:
          propertyId: path.propertyId
      - text: Show hotel property {propertyId}.
        slots:
          propertyId: path.propertyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-suppliers/property-rooms'].get
  update:
    x-apievangelist-phrasing:
      intent: List supplier property rooms
      effect: read
      questions:
      - What room types do supplier properties offer?
      - Can I filter property rooms to one hotel?
      instructions:
      - text: List supplier property rooms.
      - text: List property rooms matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-suppliers/property-rooms/{roomId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a supplier property room
      effect: read
      questions:
      - Can I read the data for one hotel room by its room ID?
      - What details are stored for a specific property room?
      instructions:
      - text: Get property room {roomId}.
        slots:
          roomId: path.roomId
      - text: Show the room record {roomId}.
        slots:
          roomId: path.roomId
      method: generated
      generated: '2026-09-26'