API Evangelist conversational phrasing for OPERA Cloud Reservation Master Data Management Reservation…

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for OPERA Cloud Reservation Master Data Management Reservation…
  version: 1.0.0
extends: openapi/oracle-hospitality-reservationconfig-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: 79
- target: $.paths['/alertCodes'].get
  update:
    x-apievangelist-phrasing:
      intent: List alert code templates
      effect: read
      questions:
      - Which alert code templates are set up at the template level in OPERA Cloud?
      - Can I look up alert code templates with a wildcard match on the code?
      instructions:
      - text: List all alert code templates.
      - text: Show the alert code template {alert_code}.
        slots:
          alert_code: query.alertCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/alertCodes'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an alert code template
      effect: write
      questions:
      - How can I edit the wording of an existing alert code template?
      - Can I change an alert code template without recreating it?
      instructions:
      - text: 'Update the alert code template with these changes: {alert_templates}.'
        slots:
          alert_templates: requestBody.alertTemplates
      - text: Change the existing alert code template definitions to {alert_templates}.
        slots:
          alert_templates: requestBody.alertTemplates
      method: generated
      generated: '2026-09-26'
- target: $.paths['/alertCodes'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an alert code template
      effect: write
      questions:
      - How do I add a new alert code template that properties can reuse?
      - Can I define a brand-new alert code at the template level?
      instructions:
      - text: 'Create a new alert code template: {alert_templates}.'
        slots:
          alert_templates: requestBody.alertTemplates
      - text: Add alert code templates {alert_templates} to the template library.
        slots:
          alert_templates: requestBody.alertTemplates
      method: generated
      generated: '2026-09-26'
- target: $.paths['/alertCodes'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete alert code templates
      effect: destructive
      questions:
      - Can I remove an alert code template I no longer need?
      - What happens if I delete several alert code templates at once?
      instructions:
      - text: Delete the alert code template {template_codes}.
        slots:
          template_codes: query.alertCodeTemplateCodes
      - text: Remove alert code templates {template_codes} from the templates list.
        slots:
          template_codes: query.alertCodeTemplateCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autoAttachElements'].put
  update:
    x-apievangelist-phrasing:
      intent: Delete auto attach element rules
      effect: destructive
      questions:
      - How can I remove an auto attach element rule from a property?
      - Is there a way to stop a rule from auto-filling fields on new reservations by deleting it?
      instructions:
      - text: Delete the auto attach element rules {rules}.
        slots:
          rules: requestBody.autoAttachRules
      - text: Remove auto attach rule {rules} so it no longer applies to new reservations.
        slots:
          rules: requestBody.autoAttachRules
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ecoupons'].get
  update:
    x-apievangelist-phrasing:
      intent: List eCoupon codes across properties
      effect: read
      questions:
      - Which eCoupon codes are configured across my properties?
      - Can I find eCoupon codes tied to a particular rate plan, including inactive ones?
      instructions:
      - text: List eCoupon codes for hotels {hotel_ids}.
        slots:
          hotel_ids: query.hotelIds
      - text: Find eCoupon codes linked to rate plan {rate_plan}, including inactive codes.
        slots:
          rate_plan: query.ratePlansCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/globalAlerts'].get
  update:
    x-apievangelist-phrasing:
      intent: List global alerts for a property
      effect: read
      questions:
      - What global alerts fire automatically on reservations at my hotel?
      - Can I list only the global alerts that are welcome offers?
      instructions:
      - text: List the global alerts configured for hotel {hotel_ids}.
        slots:
          hotel_ids: query.hotelIds
      - text: Show global alert {alert_code} for hotel {hotel_ids}.
        slots:
          alert_code: query.alertCodes
          hotel_ids: query.hotelIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/globalAlerts'].put
  update:
    x-apievangelist-phrasing:
      intent: Delete a global alert
      effect: destructive
      questions:
      - How do I delete a global alert so it stops appearing on reservations?
      - Can I remove a global alert from a property entirely?
      instructions:
      - text: Delete the global alerts {global_alerts}.
        slots:
          global_alerts: requestBody.globalAlerts
      - text: Remove global alert {global_alerts} from the property.
        slots:
          global_alerts: requestBody.globalAlerts
      method: generated
      generated: '2026-09-26'
- target: $.paths['/globalAlerts/copy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy global alerts to other properties
      effect: write
      questions:
      - Can I copy a global alert from one hotel to another instead of rebuilding it?
      - What does it take to duplicate global alerts across properties?
      instructions:
      - text: 'Copy global alerts using these instructions: {copy_instructions}.'
        slots:
          copy_instructions: requestBody.copyInstructions
      - text: Duplicate the global alert to the target hotels in {copy_instructions}.
        slots:
          copy_instructions: requestBody.copyInstructions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/guestMessages'].get
  update:
    x-apievangelist-phrasing:
      intent: List guest message templates
      effect: read
      questions:
      - Which standard guest message templates exist for front desk staff to use?
      - Can I search guest message templates by code with a wildcard?
      instructions:
      - text: List all guest message templates.
      - text: Show the guest message template {message_code}.
        slots:
          message_code: query.guestMessageCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/guestMessages'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a guest message template
      effect: write
      questions:
      - How can I reword a standard guest message template?
      - Can I edit an existing guest message template's text?
      instructions:
      - text: Update the guest message templates with {templates}.
        slots:
          templates: requestBody.guestMessageTemplates
      - text: Change the text of guest message template {templates}.
        slots:
          templates: requestBody.guestMessageTemplates
      method: generated
      generated: '2026-09-26'
- target: $.paths['/guestMessages'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a guest message template
      effect: write
      questions:
      - How do I set up a standard message text so guest messages stay consistent?
      - Can I create a reusable template for messages left for guests?
      instructions:
      - text: 'Create a new guest message template: {templates}.'
        slots:
          templates: requestBody.guestMessageTemplates
      - text: Add the standard guest message templates {templates}.
        slots:
          templates: requestBody.guestMessageTemplates
      method: generated
      generated: '2026-09-26'
- target: $.paths['/guestMessages'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete guest message templates
      effect: destructive
      questions:
      - Can I delete a guest message template nobody uses anymore?
      - What is needed to remove guest message templates by code?
      instructions:
      - text: Delete guest message template {template_codes}.
        slots:
          template_codes: query.guestMessageTemplateCodes
      - text: Remove the guest message templates {template_codes}.
        slots:
          template_codes: query.guestMessageTemplateCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/alertCodes'].get
  update:
    x-apievangelist-phrasing:
      intent: List a hotel's alert codes
      effect: read
      questions:
      - What alert codes are configured at a specific hotel?
      - Can I look up one hotel's alert codes by partial code?
      instructions:
      - text: List the alert codes for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Show alert code {code} at hotel {hotel}.
        slots:
          code: query.code
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/alertCodes'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a hotel's alert codes
      effect: write
      questions:
      - How can I change an alert code that is set up at one property?
      - Can I edit a hotel-level alert code's description?
      instructions:
      - text: Update the alert codes at hotel {hotel} with {alerts}.
        slots:
          hotel: path.hotelId
          alerts: requestBody.alerts
      - text: Change alert code settings for hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/alertCodes'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an alert code at a hotel
      effect: write
      questions:
      - How do I add a new alert code for just one hotel?
      - Can a single property have its own alert codes outside the templates?
      instructions:
      - text: Create alert code {alerts} at hotel {hotel}.
        slots:
          alerts: requestBody.alerts
          hotel: path.hotelId
      - text: Add a new property alert code for hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/alertCodes'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a hotel's alert code
      effect: destructive
      questions:
      - Can I delete an alert code from a single property?
      - What happens when I remove a hotel-level alert code?
      instructions:
      - text: Delete alert code {codes} at hotel {hotel}.
        slots:
          codes: query.codes
          hotel: path.hotelId
      - text: Remove the property alert codes {codes} from hotel {hotel}.
        slots:
          codes: query.codes
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/autoAttachElements'].get
  update:
    x-apievangelist-phrasing:
      intent: List auto attach element rules
      effect: read
      questions:
      - Which rules auto-fill fields on new reservations at my hotel?
      - Can I see auto attach element rules filtered by type, including inactive ones?
      instructions:
      - text: List the auto attach element rules for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Show auto attach rule {code} at hotel {hotel}.
        slots:
          code: query.code
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/autoAttachElements'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an auto attach element rule
      effect: write
      questions:
      - How can I modify an existing auto attach element rule on a property?
      - Can I change which reservation fields an existing auto attach rule sets?
      instructions:
      - text: Update the auto attach rules at hotel {hotel} to {rules}.
        slots:
          hotel: path.hotelId
          rules: requestBody.autoAttachRules
      - text: Modify the existing auto attach element rule configuration for hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/autoAttachElements'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an auto attach element rule
      effect: write
      questions:
      - How do I create a rule that automatically sets fields on every new reservation?
      - Is there a way to add a new auto attach element rule to a hotel?
      instructions:
      - text: Create a new auto attach element rule {rules} at hotel {hotel}.
        slots:
          rules: requestBody.autoAttachRules
          hotel: path.hotelId
      - text: Add an auto attach rule for new reservations at hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/autoAttachElements/copy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy auto attach element rules
      effect: write
      questions:
      - Can I copy an auto attach rule to other properties?
      - What is the quickest way to duplicate an auto attach element rule?
      instructions:
      - text: Copy auto attach rule {rule} from hotel {hotel}.
        slots:
          rule: requestBody.autoAttachRule
          hotel: path.hotelId
      - text: Duplicate the auto attach element rules at hotel {hotel} to other properties.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/colors'].get
  update:
    x-apievangelist-phrasing:
      intent: List reservation colors
      effect: read
      questions:
      - What reservation colors are defined at my hotel?
      - Can I include inactive reservation colors when listing them?
      instructions:
      - text: List the reservation colors for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Find reservation colors described as {description} at hotel {hotel}.
        slots:
          description: query.description
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/colors/{code}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a reservation color
      effect: write
      questions:
      - How can I change the settings of a reservation color?
      - Can I edit one reservation color by its code?
      instructions:
      - text: Update reservation color {code} at hotel {hotel}.
        slots:
          code: path.code
          hotel: path.hotelId
      - text: Change reservation color {code} at hotel {hotel} to {colors}.
        slots:
          code: path.code
          hotel: path.hotelId
          colors: requestBody.reservationColors
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/ecouponCodes/{ecouponCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an eCoupon code
      effect: destructive
      questions:
      - How do I delete an eCoupon code from a hotel?
      - Can I remove a single eCoupon that is no longer valid?
      instructions:
      - text: Delete eCoupon code {ecoupon} at hotel {hotel}.
        slots:
          ecoupon: path.ecouponCode
          hotel: path.hotelId
      - text: Remove the eCoupon {ecoupon} from hotel {hotel}.
        slots:
          ecoupon: path.ecouponCode
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/ecoupons'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an eCoupon code
      effect: write
      questions:
      - How can I change the quantity or rate plan on an existing eCoupon?
      - Can I edit an eCoupon code that already exists at my hotel?
      instructions:
      - text: Update the existing eCoupon codes at hotel {hotel} with {ecoupons}.
        slots:
          hotel: path.hotelId
          ecoupons: requestBody.eCouponCodes
      - text: Change an existing eCoupon at hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/ecoupons'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an eCoupon code
      effect: write
      questions:
      - How long can a new eCoupon code be, and what quantity can it have?
      - Can I create an eCoupon for one specific property?
      instructions:
      - text: Create eCoupon code {ecoupons} at hotel {hotel}.
        slots:
          ecoupons: requestBody.eCouponCodes
          hotel: path.hotelId
      - text: Add a brand-new eCoupon for hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/ecoupons/copy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy eCoupon codes
      effect: write
      questions:
      - Can I copy an existing eCoupon to create a new one?
      - What do I need to duplicate eCoupon codes from one hotel?
      instructions:
      - text: Copy eCoupon codes at hotel {hotel} using {copy}.
        slots:
          hotel: path.hotelId
          copy: requestBody.eCouponCopy
      - text: Duplicate an existing eCoupon at hotel {hotel} into a new code.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/globalAlerts'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a hotel's global alerts
      effect: write
      questions:
      - How can I change the condition on a global alert at my hotel?
      - Can I edit an existing global alert for one property?
      instructions:
      - text: Update the global alerts at hotel {hotel} with {global_alerts}.
        slots:
          hotel: path.hotelId
          global_alerts: requestBody.globalAlerts
      - text: Change the existing global alert settings for hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/globalAlerts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a global alert
      effect: write
      questions:
      - How do I create an alert that appears automatically on every reservation matching a condition?
      - Can I set up a new global alert for one hotel?
      instructions:
      - text: Create global alert {global_alerts} at hotel {hotel}.
        slots:
          global_alerts: requestBody.globalAlerts
          hotel: path.hotelId
      - text: Add a new automatic global alert for hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/guestMessages'].get
  update:
    x-apievangelist-phrasing:
      intent: List a hotel's guest messages
      effect: read
      questions:
      - What guest messages are configured at my hotel?
      - Is there a maximum page size when listing a hotel's guest messages?
      instructions:
      - text: List the guest messages for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Show guest message {message_code} at hotel {hotel}.
        slots:
          message_code: query.guestMessageCodes
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/guestMessages'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a hotel's guest message
      effect: write
      questions:
      - How can I edit a guest message configured at one property?
      - Can I change the text of a hotel-level guest message?
      instructions:
      - text: Update guest messages at hotel {hotel} to {messages}.
        slots:
          hotel: path.hotelId
          messages: requestBody.guestMessages
      - text: Change a hotel guest message at property {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/guestMessages'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a hotel guest message
      effect: write
      questions:
      - How do I add a new guest message at a particular hotel?
      - Can I create property-specific guest messages?
      instructions:
      - text: Create guest message {messages} at hotel {hotel}.
        slots:
          messages: requestBody.guestMessages
          hotel: path.hotelId
      - text: Add a new property guest message for hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/guestMessages/{messageCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a hotel guest message
      effect: destructive
      questions:
      - Can I delete one guest message from a hotel by its code?
      - What is required to remove a property guest message?
      instructions:
      - text: Delete guest message {message_code} at hotel {hotel}.
        slots:
          message_code: path.messageCode
          hotel: path.hotelId
      - text: Remove the hotel guest message {message_code} from property {hotel}.
        slots:
          message_code: path.messageCode
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/locatorCodes'].get
  update:
    x-apievangelist-phrasing:
      intent: List a hotel's locator codes
      effect: read
      questions:
      - Which locator codes exist at my hotel for tracking where guests are?
      - Can I include inactive locator codes when listing a property's codes?
      instructions:
      - text: List the locator codes for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Show locator code {locator} at hotel {hotel}.
        slots:
          locator: query.locatorCodes
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/locatorCodes'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a hotel's locator code
      effect: write
      questions:
      - How can I change a locator code at one property?
      - Can I edit the description of a hotel's locator code?
      instructions:
      - text: Update locator codes at hotel {hotel} with {locators}.
        slots:
          hotel: path.hotelId
          locators: requestBody.locatorCodes
      - text: Change an existing locator code at property {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/locatorCodes'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a hotel locator code
      effect: write
      questions:
      - How do I add a new locator code at a specific hotel?
      - Can each property create its own locator codes?
      instructions:
      - text: Create locator code {locators} at hotel {hotel}.
        slots:
          locators: requestBody.locatorCodes
          hotel: path.hotelId
      - text: Add a new property locator code for hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/locatorCodes/{locatorCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a hotel locator code
      effect: destructive
      questions:
      - Can I delete a locator code from one hotel?
      - What is needed to remove a single property locator code?
      instructions:
      - text: Delete locator code {locator} at hotel {hotel}.
        slots:
          locator: path.locatorCode
          hotel: path.hotelId
      - text: Remove the property locator code {locator} from hotel {hotel}.
        slots:
          locator: path.locatorCode
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/membershipLevels/ratings'].get
  update:
    x-apievangelist-phrasing:
      intent: List membership level ratings
      effect: read
      questions:
      - What ratings are assigned to each membership level at my hotel?
      - Can I filter membership level ratings by membership type?
      instructions:
      - text: List membership level ratings for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Show ratings for membership type {membership_type} at hotel {hotel}.
        slots:
          membership_type: query.membershipTypeCodes
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/membershipTypes/{membershipType}/membershipLevels/{membershipLevel}/ratings'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a membership level's rating
      effect: write
      questions:
      - How can I change the rating given to a membership level?
      - Can I re-rate one level of a loyalty membership type?
      instructions:
      - text: Update the rating for level {level} of membership {membership_type} at hotel {hotel}.
        slots:
          level: path.membershipLevel
          membership_type: path.membershipType
          hotel: path.hotelId
      - text: Set membership level {level} in {membership_type} at hotel {hotel} to {ratings}.
        slots:
          level: path.membershipLevel
          membership_type: path.membershipType
          hotel: path.hotelId
          ratings: requestBody.membershipLevelRatingsInfo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/ratePlans/ratings'].get
  update:
    x-apievangelist-phrasing:
      intent: List rate plan ratings
      effect: read
      questions:
      - What ratings are assigned to the rate plans at my hotel?
      - Can I list rate plan ratings for a single rate category?
      instructions:
      - text: List rate plan ratings for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Show the rating of rate plan {rate_plan} at hotel {hotel}.
        slots:
          rate_plan: query.ratePlanCodes
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/ratePlans/ratings'].put
  update:
    x-apievangelist-phrasing:
      intent: Update rate plan ratings
      effect: write
      questions:
      - How can I change the rating on a rate plan?
      - Can I re-rate several rate plans at one hotel together?
      instructions:
      - text: Update rate plan ratings at hotel {hotel} to {ratings}.
        slots:
          hotel: path.hotelId
          ratings: requestBody.ratePlanRatingsInfo
      - text: Change the rate plan ratings for hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservationProtectionCondition'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the reservation protection condition
      effect: read
      questions:
      - Under what condition are reservations automatically marked as protected at my hotel?
      - Is a reservation protection condition configured for this property?
      instructions:
      - text: Show the reservation protection condition for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Get the rule that auto-protects reservations at hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservationProtectionCondition'].put
  update:
    x-apievangelist-phrasing:
      intent: Change the reservation protection condition
      effect: write
      questions:
      - How can I change when reservations get automatically protected?
      - Can I edit an existing reservation protection condition?
      instructions:
      - text: Change the reservation protection condition at hotel {hotel} to {condition}.
        slots:
          hotel: path.hotelId
          condition: requestBody.reservationProtectionCondition
      - text: Modify the existing auto-protect condition for hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservationProtectionCondition'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a reservation protection condition
      effect: write
      questions:
      - How do I set up automatic protection for reservations at a hotel for the first time?
      - Can I define a new condition that marks reservations as protected?
      instructions:
      - text: Create a reservation protection condition {condition} at hotel {hotel}.
        slots:
          condition: requestBody.reservationProtectionCondition
          hotel: path.hotelId
      - text: Set up a new auto-protect condition for reservations at hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservationProtectionCondition'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete the reservation protection condition
      effect: destructive
      questions:
      - Can I turn off automatic reservation protection by deleting its condition?
      - What happens when I remove a hotel's reservation protection condition?
      instructions:
      - text: Delete the reservation protection condition for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Remove the auto-protect condition at hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/roomFeatures/ratings'].get
  update:
    x-apievangelist-phrasing:
      intent: List room feature ratings
      effect: read
      questions:
      - What ratings are set for room features like views or balconies at my hotel?
      - Can I search room feature ratings by description?
      instructions:
      - text: List room feature ratings for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Show the rating of room feature {feature} at hotel {hotel}.
        slots:
          feature: query.featureCodes
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/roomFeatures/ratings'].put
  update:
    x-apievangelist-phrasing:
      intent: Update room feature ratings
      effect: write
      questions:
      - How can I change the rating attached to a room feature?
      - Can I re-rate room features at a property?
      instructions:
      - text: Update room feature ratings at hotel {hotel} to {ratings}.
        slots:
          hotel: path.hotelId
          ratings: requestBody.roomFeatureRatingsInfo
      - text: Change the room feature ratings for hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/roomSpecials/ratings'].get
  update:
    x-apievangelist-phrasing:
      intent: List room special ratings
      effect: read
      questions:
      - Which ratings are assigned to room specials at my hotel?
      - Can I filter room special ratings by rating value?
      instructions:
      - text: List room special ratings for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Show the rating of room special {special} at hotel {hotel}.
        slots:
          special: query.specialCodes
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'


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