# 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-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:
      - Which hotel brands are in the travel supplier directory?
      - Can I filter supplier brands by name?
      instructions:
      - text: List all 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:
      - How do I look up one hotel brand by its brand code?
      - What details are stored for a supplier brand?
      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:
      - What hotel chains are available as travel suppliers?
      - Can I filter the list of supplier chains?
      instructions:
      - text: List all 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:
      - How do I look up a hotel chain by its chain ID?
      - What information is available for a supplier chain?
      instructions:
      - text: Get supplier chain {chainId}.
        slots:
          chainId: path.chainId
      - text: Show details for 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 properties
      effect: read
      questions:
      - Which hotel properties are in the supplier directory?
      - Can I find properties updated after a given date?
      instructions:
      - text: List all supplier properties.
      - text: List supplier 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:
      - How do I get the details of one hotel property?
      - How do I pull the full record for one hotel in the supplier directory?
      instructions:
      - text: Get supplier property {propertyId}.
        slots:
          propertyId: path.propertyId
      - text: Show hotel property {propertyId}'s details.
        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 supplier property rooms?
      instructions:
      - text: List all 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:
      - How do I read the details of one hotel room type?
      - What data is stored for a single hotel room when I have its room ID?
      instructions:
      - text: Get supplier property room {roomId}.
        slots:
          roomId: path.roomId
      - text: Show details for property room {roomId}.
        slots:
          roomId: path.roomId
      method: generated
      generated: '2026-09-26'