API Evangelist conversational phrasing for Oracle Hospitality Hotel Config API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Oracle Hospitality Hotel Config API
  version: 1.0.0
extends: openapi/oracle-hospitality-hotelconfig-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 455
- target: $.paths['/availablePreferences'].get
  update:
    x-apievangelist-phrasing:
      intent: List guest preferences available at a property
      effect: read
      questions:
      - Which guest preferences can staff pick from at a given hotel?
      - Can I only see the preferences that are flagged for use on reservations?
      - What preference types are set up for a property in OPERA?
      instructions:
      - text: Show the available guest preferences for hotel {hotelId}.
        slots:
          hotelId: query.hotelId
      - text: List preferences of type {preferenceType} at property {hotelId} that apply to reservations only.
        slots:
          preferenceType: query.preferenceType
          hotelId: query.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/communicationTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List communication types
      effect: read
      questions:
      - What communication types (phone, email, fax) are configured?
      - Can I filter communication types by role, such as email or phone?
      instructions:
      - text: List all configured communication types.
      - text: Find communication types with role {roles}.
        slots:
          roles: query.roles
      - text: Look up communication type codes {codes}.
        slots:
          codes: query.codes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/communicationTypes'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a communication type
      effect: write
      questions:
      - How do I add a new communication type like a messaging app to the configuration?
      - Can I define my own communication type code for guest contact methods?
      instructions:
      - text: Create a new communication type {communicationType}.
        slots:
          communicationType: requestBody.communicationType
      - text: Add a communication type for WhatsApp contact details.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/communicationTypes/{communicationTypeCode}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a communication type
      effect: write
      questions:
      - Can I rename or change the role of an existing communication type?
      - How do I edit a communication type that's already configured?
      instructions:
      - text: Update communication type {communicationTypeCode}.
        slots:
          communicationTypeCode: path.communicationTypeCode
      - text: Change the description of communication type {communicationTypeCode} to {communicationType}.
        slots:
          communicationTypeCode: path.communicationTypeCode
          communicationType: requestBody.communicationType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/communicationTypes/{communicationTypeCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a communication type
      effect: destructive
      questions:
      - Can I remove a communication type we no longer use?
      - What happens if I delete an existing communication type code?
      instructions:
      - text: Delete communication type {communicationTypeCode}.
        slots:
          communicationTypeCode: path.communicationTypeCode
      - text: Remove the {communicationTypeCode} communication type from the configuration.
        slots:
          communicationTypeCode: path.communicationTypeCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/services/hotelConfig/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the hotel configuration service is up
      effect: read
      questions:
      - Is the hotel configuration service currently available?
      - Can I health-check the OPERA hotel config service before making calls?
      instructions:
      - text: Ping the hotel configuration service.
      - text: Check the hotel config service status while logged in to hotel {hotelId}.
        slots:
          hotelId: header.x-hotelid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/airports'].get
  update:
    x-apievangelist-phrasing:
      intent: List template airports
      effect: read
      questions:
      - Which airports are defined at the template level for the chain?
      - Can I look up template airports by airport code?
      instructions:
      - text: List all template airports.
      - text: Show template airports with codes {airportCodes}.
        slots:
          airportCodes: query.airportCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/airports'].post
  update:
    x-apievangelist-phrasing:
      intent: Create template airports
      effect: write
      questions:
      - How do I add an airport to the chain-wide template list?
      - Can I create several template airports in one request?
      instructions:
      - text: Create template airports {templateAirports}.
        slots:
          templateAirports: requestBody.templateAirports
      - text: Add a new airport to the template airport list.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/airports/{airportCode}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a template airport
      effect: write
      questions:
      - Can I change the details of an airport in the template list?
      - What's the way to edit a template airport's name or location?
      instructions:
      - text: Update template airport {airportCode}.
        slots:
          airportCode: path.airportCode
      - text: Change template airport {airportCode} to {templateAirports}.
        slots:
          airportCode: path.airportCode
          templateAirports: requestBody.templateAirports
      method: generated
      generated: '2026-09-26'
- target: $.paths['/airports/{airportCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a template airport
      effect: destructive
      questions:
      - Can I remove an airport from the chain's template airports?
      - Is deleting a template airport permanent?
      instructions:
      - text: Delete template airport {airportCode}.
        slots:
          airportCode: path.airportCode
      - text: Remove {airportCode} from the template airports.
        slots:
          airportCode: path.airportCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/amenities'].get
  update:
    x-apievangelist-phrasing:
      intent: List template amenities
      effect: read
      questions:
      - What amenities are defined at the template level?
      - Can I see only the meeting-room amenities in the template list?
      - Which general template amenities exist for the chain?
      instructions:
      - text: List all template amenities.
      - text: Show template amenities with codes {amenityCodes}.
        slots:
          amenityCodes: query.amenityCodes
      - text: List only the meeting template amenities.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/amenities'].post
  update:
    x-apievangelist-phrasing:
      intent: Create template amenities
      effect: write
      questions:
      - How do I add a new amenity to the chain-level template?
      - Can I define template amenities that properties can later use?
      instructions:
      - text: Create template amenities {templateAmenities}.
        slots:
          templateAmenities: requestBody.templateAmenities
      - text: Add a rooftop pool amenity to the template amenities.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/amenities/{featureCode}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a template amenity
      effect: write
      questions:
      - Can I edit a template amenity's description?
      - What's involved in changing an amenity defined at the template level?
      instructions:
      - text: Update template amenity {featureCode}.
        slots:
          featureCode: path.featureCode
      - text: Change template amenity {featureCode} to {templateAmenities}.
        slots:
          featureCode: path.featureCode
          templateAmenities: requestBody.templateAmenities
      method: generated
      generated: '2026-09-26'
- target: $.paths['/amenities/{featureCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a template amenity
      effect: destructive
      questions:
      - Can I delete an amenity from the template list?
      - Does removing a template amenity affect the chain's amenity catalog?
      instructions:
      - text: Delete template amenity {featureCode}.
        slots:
          featureCode: path.featureCode
      - text: Remove the {featureCode} amenity from the templates.
        slots:
          featureCode: path.featureCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/attractions'].get
  update:
    x-apievangelist-phrasing:
      intent: Search attraction templates
      effect: read
      questions:
      - Which attraction templates are set up for the chain?
      - Can I search attraction templates by class or a wildcard name?
      instructions:
      - text: List all attraction templates.
      - text: Find attraction templates in class {classCodes}.
        slots:
          classCodes: query.classCodes
      - text: Search attraction templates matching {wildCard}.
        slots:
          wildCard: query.wildCard
      method: generated
      generated: '2026-09-26'
- target: $.paths['/attractions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an attraction template
      effect: write
      questions:
      - How do I add a local attraction as a chain-level template?
      - Can I create attraction templates that properties reuse?
      instructions:
      - text: Create attraction template {attractionTemplates}.
        slots:
          attractionTemplates: requestBody.attractionTemplates
      - text: Add a new museum attraction template.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/attractions/{attractionCode}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an attraction template
      effect: write
      questions:
      - Can I change the details of an existing attraction template?
      - What's the way to edit a template attraction's class or description?
      instructions:
      - text: Update attraction template {attractionCode}.
        slots:
          attractionCode: path.attractionCode
      - text: Change attraction template {attractionCode} to {attractionTemplates}.
        slots:
          attractionCode: path.attractionCode
          attractionTemplates: requestBody.attractionTemplates
      method: generated
      generated: '2026-09-26'
- target: $.paths['/attractions/{attractionCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an attraction template
      effect: destructive
      questions:
      - Can I delete an attraction template we no longer promote?
      - Is there a way to remove a template-level attraction?
      instructions:
      - text: Delete attraction template {attractionCode}.
        slots:
          attractionCode: path.attractionCode
      - text: Remove the {attractionCode} attraction template.
        slots:
          attractionCode: path.attractionCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calendar'].get
  update:
    x-apievangelist-phrasing:
      intent: Get calendar entries for a date range
      effect: read
      questions:
      - What day types and events are on the hotel calendar between two dates?
      - Can I pull calendar entries without putting the hotel in the path?
      instructions:
      - text: Get calendar entries from {startDate} to {endDate} with {fetchInstructions}.
        slots:
          startDate: query.startDate
          endDate: query.endDate
          fetchInstructions: query.fetchInstructions
      - text: Show the calendar for hotel {hotelId} from {startDate} to {endDate}, fetching {fetchInstructions}, using the query-parameter endpoint.
        slots:
          hotelId: query.hotelId
          startDate: query.startDate
          endDate: query.endDate
          fetchInstructions: query.fetchInstructions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/configurations/activityLogs'].get
  update:
    x-apievangelist-phrasing:
      intent: Search configuration activity logs
      effect: read
      questions:
      - Who changed a configuration setting and when?
      - Can I filter config activity logs by module, user or date range?
      - What configuration changes were made at a property last week?
      instructions:
      - text: Show configuration activity logs for hotel {hotelId} from {fromDate} to {toDate}.
        slots:
          hotelId: query.hotelId
          fromDate: query.fromDate
          toDate: query.toDate
      - text: Find config activity in module {module} changed by user {userByIds}.
        slots:
          module: query.module
          userByIds: query.userByIds
      - text: Search configuration activity logs for {searchText}.
        slots:
          searchText: query.searchText
      method: generated
      generated: '2026-09-26'
- target: $.paths['/configurations/activityLogs'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a configuration activity log entry
      effect: write
      questions:
      - How do I write my own entry into the configuration activity log?
      - Can an integration log the config changes it makes?
      instructions:
      - text: Create a configuration activity log entry {configActivities}.
        slots:
          configActivities: requestBody.configActivities
      - text: Log a config activity recording the change I just made.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/countries'].get
  update:
    x-apievangelist-phrasing:
      intent: List template countries
      effect: read
      questions:
      - Which countries are defined at the template level?
      - Can I search template countries with a wildcard?
      instructions:
      - text: List all template countries.
      - text: Show template countries with codes {countriesCodes}.
        slots:
          countriesCodes: query.countriesCodes
      - text: Find template countries matching {wildCard}.
        slots:
          wildCard: query.wildCard
      method: generated
      generated: '2026-09-26'
- target: $.paths['/countries'].post
  update:
    x-apievangelist-phrasing:
      intent: Create template countries
      effect: write
      questions:
      - How do I add a country to the chain-wide template list?
      - Can I create several template countries at once?
      instructions:
      - text: Create template countries {templateCountries}.
        slots:
          templateCountries: requestBody.templateCountries
      - text: Add a new country to the template countries.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/countries/{countryCode}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a template country
      effect: write
      questions:
      - Can I edit a country's details at the template level?
      - What's the way to fix a template country's name or address format?
      instructions:
      - text: Update template country {countryCode}.
        slots:
          countryCode: path.countryCode
      - text: Change template country {countryCode} to {templateCountries}.
        slots:
          countryCode: path.countryCode
          templateCountries: requestBody.templateCountries
      method: generated
      generated: '2026-09-26'
- target: $.paths['/countries/{countryCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a template country
      effect: destructive
      questions:
      - Can I remove a country from the template countries?
      - Is deleting a template country code reversible?
      instructions:
      - text: Delete template country {countryCode}.
        slots:
          countryCode: path.countryCode
      - text: Remove {countryCode} from the template country list.
        slots:
          countryCode: path.countryCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/currencyExchangeRates'].get
  update:
    x-apievangelist-phrasing:
      intent: Get currency exchange rates
      effect: read
      questions:
      - What exchange rates are loaded for a currency at our hotels?
      - Can I filter exchange rates by exchange type, such as cash or check?
      - Which currency conversion rates apply across several properties?
      instructions:
      - text: Get exchange rates for currency {currencyCode}.
        slots:
          currencyCode: query.currencyCode
      - text: Show {exchangeType} exchange rates for hotels {hotelIds}.
        slots:
          exchangeType: query.exchangeType
          hotelIds: query.hotelIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dayTypeCodes'].get
  update:
    x-apievangelist-phrasing:
      intent: List template day type codes
      effect: read
      questions:
      - Which day type codes are defined at the template level?
      - Can I search template day types with a wildcard?
      instructions:
      - text: List all template day type codes.
      - text: Show template day type codes {dayTypesCodes}.
        slots:
          dayTypesCodes: query.dayTypesCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dayTypeCodes'].put
  update:
    x-apievangelist-phrasing:
      intent: Update template day type codes
      effect: write
      questions:
      - Can I edit the template-level day type codes like high or low season?
      - How do I change a day type code's description in the template?
      instructions:
      - text: Update template day type codes {templateDayTypeCodes}.
        slots:
          templateDayTypeCodes: requestBody.templateDayTypeCodes
      - text: Change the template day type code descriptions.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dayTypeCodes'].post
  update:
    x-apievangelist-phrasing:
      intent: Create template day type codes
      effect: write
      questions:
      - How do I add a new day type code, like a special event day, to the template?
      - Can I define template day types that properties inherit?
      instructions:
      - text: Create template day type codes {templateDayTypeCodes}.
        slots:
          templateDayTypeCodes: requestBody.templateDayTypeCodes
      - text: Add a peak-season template day type code.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dayTypeCodes'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete template day type codes
      effect: destructive
      questions:
      - Can I delete day type codes from the template?
      - What's the way to remove obsolete template day types?
      instructions:
      - text: Delete template day type codes {templateDayTypeCodes}.
        slots:
          templateDayTypeCodes: query.templateDayTypeCodes
      - text: Remove the unused template day type codes.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dayTypes'].put
  update:
    x-apievangelist-phrasing:
      intent: Assign a day type to a date range
      effect: write
      questions:
      - How do I mark a range of dates as high season on the hotel calendar?
      - Can I set a day type for specific dates only?
      instructions:
      - text: Set day types {hotelDayTypes} for the date range.
        slots:
          hotelDayTypes: requestBody.hotelDayTypes
      - text: Mark next month's weekends as a peak day type on the calendar.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dayTypes/{dayType}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Clear a day type from a date range
      effect: destructive
      questions:
      - Can I remove a day type from the calendar for certain dates?
      - Is it possible to clear a day type only on selected weekdays?
      instructions:
      - text: Remove day type {dayType} from hotel {hotelId} between {startDate} and {endDate}.
        slots:
          dayType: path.dayType
          hotelId: query.hotelId
          startDate: query.startDate
          endDate: query.endDate
      - text: Clear day type {dayType} from the calendar.
        slots:
          dayType: path.dayType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/departments'].get
  update:
    x-apievangelist-phrasing:
      intent: List departments
      effect: read
      questions:
      - Which departments are configured at our hotels?
      - Can I search departments by a wildcard name?
      instructions:
      - text: List departments for hotels {hotelIds}.
        slots:
          hotelIds: query.hotelIds
      - text: Show departments with codes {departmentCodes}.
        slots:
          departmentCodes: query.departmentCodes
      - text: Find departments matching {departmentWildCard}.
        slots:
          departmentWildCard: query.departmentWildCard
      method: generated
      generated: '2026-09-26'
- target: $.paths['/departments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create departments
      effect: write
      questions:
      - How do I add a new department like housekeeping or engineering?
      - Can I create several departments in one call?
      instructions:
      - text: Create departments {departments}.
        slots:
          departments: requestBody.departments
      - text: Add a spa department to the hotel.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/departments/{departmentCode}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a department
      effect: write
      questions:
      - Can I rename an existing department?
      - What's the way to change a department's details?
      instructions:
      - text: Update department {departmentCode}.
        slots:
          departmentCode: path.departmentCode
      - text: Change department {departmentCode} to {departments}.
        slots:
          departmentCode: path.departmentCode
          departments: requestBody.departments
      method: generated
      generated: '2026-09-26'
- target: $.paths['/departments/{departmentCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a department
      effect: destructive
      questions:
      - Can I delete a department we no longer have?
      - Does deleting a department apply to one hotel only?
      instructions:
      - text: Delete department {departmentCode}.
        slots:
          departmentCode: path.departmentCode
      - text: Remove department {departmentCode} from hotel {hotelId}.
        slots:
          departmentCode: path.departmentCode
          hotelId: query.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotelDetails'].get
  update:
    x-apievangelist-phrasing:
      intent: List template hotel details
      effect: read
      questions:
      - What hotel detail items are defined at the template level?
      - Can I filter template hotel details by category?
      instructions:
      - text: List all template hotel details.
      - text: Show template hotel details in categories {hotelDetailCategoriesCodes}.
        slots:
          hotelDetailCategoriesCodes: query.hotelDetailCategoriesCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotelDetails'].put
  update:
    x-apievangelist-phrasing:
      intent: Update template hotel details
      effect: write
      questions:
      - Can I edit hotel details defined at the template level?
      - How do I change a template hotel detail's description?
      instructions:
      - text: Update template hotel details {templateHotelDetails}.
        slots:
          templateHotelDetails: requestBody.templateHotelDetails
      - text: Change the wording of the template hotel detail items.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotelDetails'].post
  update:
    x-apievangelist-phrasing:
      intent: Create template hotel details
      effect: write
      questions:
      - How do I add a new hotel detail item at the template level?
      - Can I create template hotel details that properties can copy?
      instructions:
      - text: Create template hotel details {templateHotelDetails}.
        slots:
          templateHotelDetails: requestBody.templateHotelDetails
      - text: Add a check-in policy item to the template hotel details.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotelDetails'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete template hotel details
      effect: destructive
      questions:
      - Can I delete a hotel detail item from the template?
      - Is there a way to remove a template hotel detail within a category?
      instructions:
      - text: Delete template hotel detail {templateHotelDetailCode} in category {templateHotelDetailCategory}.
        slots:
          templateHotelDetailCode: query.templateHotelDetailCode
          templateHotelDetailCategory: query.templateHotelDetailCategory
      - text: Remove template hotel detail {templateHotelDetailCode}.
        slots:
          templateHotelDetailCode: query.templateHotelDetailCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotelDetails/copy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy template hotel details to properties
      effect: write
      questions:
      - How do I push template hotel details out to other properties?
      - Can I copy hotel details from the template to several hotels at once?
      instructions:
      - text: Copy template hotel details using {copyInstructions}.
        slots:
          copyInstructions: requestBody.copyInstructions
      - text: Copy the template hotel details to our new properties.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels'].get
  update:
    x-apievangelist-phrasing:
      intent: Search hotels in the configuration
      effect: read
      questions:
      - Which hotels do we have configured in a given country?
      - Can I find properties by name, marketing city or property type?
      - What properties sit in a particular marketing region?
      instructions:
      - text: Find hotels named {name}.
        slots:
          name: query.name
      - text: List hotels in country {countryCode} of property type {propertyTypeCode}.
        slots:
          countryCode: query.countryCode
          propertyTypeCode: query.propertyTypeCode
      - text: Show hotels in marketing city {marketingCity}.
        slots:
          marketingCity: query.marketingCity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/attractions/{attractionCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an attraction by code
      effect: destructive
      questions:
      - Can I delete a property attraction by its code with the hotel passed as a query parameter?
      - Is there an endpoint to remove an attraction without the hotel in the path?
      instructions:
      - text: Delete attraction {attractionCode} for hotel {hotelId} using the hotel-as-query endpoint.
        slots:
          attractionCode: path.attractionCode
          hotelId: query.hotelId
      - text: Remove attraction code {attractionCode} via the by-code endpoint.
        slots:
          attractionCode: path.attractionCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one hotel's configuration
      effect: read
      questions:
      - What configuration details are stored for a specific property?
      - Can I fetch only certain areas of a hotel's configuration?
      instructions:
      - text: Get the configuration for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Show hotel {hotelId} configuration including {fetchInstructions}.
        slots:
          hotelId: path.hotelId
          fetchInstructions: query.fetchInstructions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a hotel's configuration
      effect: write
      questions:
      - How do I update a property's general information like address or check-in time?
      - Can I change hotel configuration details through the API?
      instructions:
      - text: Update hotel {hotelId} with {hotelInfo}.
        slots:
          hotelId: path.hotelId
          hotelInfo: requestBody.hotelInfo
      - text: Change the property information for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/airports'].get
  update:
    x-apievangelist-phrasing:
      intent: List airports near a property
      effect: read
      questions:
      - Which airports are linked to a specific hotel?
      - Can I page through the airports configured for a property?
      instructions:
      - text: List airports for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Show airport {airportCodes} as configured for hotel {hotelId}.
        slots:
          airportCodes: query.airportCodes
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/airports'].post
  update:
    x-apievangelist-phrasing:
      intent: Add airports to a property
      effect: write
      questions:
      - How do I link a nearby airport to one of our hotels?
      - Can I record distance and directions to an airport for a property?
      instructions:
      - text: Add airports {airports} to hotel {hotelId}.
        slots:
          airports: requestBody.airports
          hotelId: path.hotelId
      - text: Create a nearby airport entry for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/airports/{airportCode}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an airport at a property
      effect: write
      questions:
      - Can I edit the airport details recorded for a specific hotel?
      - How do I update the drive time to an airport for one property?
      instructions:
      - text: Update airport {airportCode} at hotel {hotelId}.
        slots:
          airportCode: path.airportCode
          hotelId: path.hotelId
      - text: Change airport {airportCode} for hotel {hotelId} to {airports}.
        slots:
          airportCode: path.airportCode
          hotelId: path.hotelId
          airports: requestBody.airports
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/airports/{airportCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an airport from a property
      effect: destructive
      questions:
      - Can I unlink an airport from one hotel without touching the template?
      - What's the way to delete a property-level airport?
      instructions:
      - text: Remove airport {airportCode} from hotel {hotelId}.
        slots:
          airportCode: path.airportCode
          hotelId: path.hotelId
      - text: Delete the {airportCode} airport entry at property {hotelId}.
        slots:
          airportCode: path.airportCode
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (303 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/overlays/oracle-hospitality-hotelconfig-api-phrasing-overlay.yaml