# 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' - target: $.paths['/hotels/{hotelId}/roomSpecials/ratings'].put update: x-apievangelist-phrasing: intent: Update room special ratings effect: write questions: - How can I change the rating on a room special? - Can I update ratings for several room specials together? instructions: - text: Update room special ratings at hotel {hotel} to {ratings}. slots: hotel: path.hotelId ratings: requestBody.roomSpecialRatingsInfo - text: Change the room special ratings for hotel {hotel}. slots: hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/rooms/ratings'].get update: x-apievangelist-phrasing: intent: List room ratings effect: read questions: - What rating does each room at my hotel have? - Can I list room ratings by room type or room class? instructions: - text: List room ratings for hotel {hotel}. slots: hotel: path.hotelId - text: Show ratings for rooms of type {room_type} at hotel {hotel}. slots: room_type: query.roomTypeCodes hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/rooms/{roomId}/ratings'].put update: x-apievangelist-phrasing: intent: Update a room's rating effect: write questions: - How can I change the rating of one specific room? - Can I re-rate a single room by its room number? instructions: - text: Update the rating of room {room} at hotel {hotel}. slots: room: path.roomId hotel: path.hotelId - text: Set room {room} at hotel {hotel} to rating {ratings}. slots: room: path.roomId hotel: path.hotelId ratings: requestBody.roomRatingsInfo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/traceTexts/copy'].put update: x-apievangelist-phrasing: intent: Copy a trace text effect: write questions: - Can I copy an existing trace text to create a new one? - What is the fastest way to duplicate trace texts at a hotel? instructions: - text: Copy trace texts at hotel {hotel} using {criteria}. slots: hotel: path.hotelId criteria: requestBody.criteria - text: Duplicate an existing trace text at hotel {hotel}. slots: hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/turnawayCodes'].get update: x-apievangelist-phrasing: intent: List a hotel's turnaway codes effect: read questions: - Which turnaway codes does my hotel use to record reservations it could not confirm? - Can I include inactive turnaway codes when listing a property's codes? instructions: - text: List the turnaway codes for hotel {hotel}. slots: hotel: path.hotelId - text: Show turnaway code {code} at hotel {hotel}. slots: code: query.code hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/turnawayCodes'].put update: x-apievangelist-phrasing: intent: Update a hotel's turnaway code effect: write questions: - How can I edit a turnaway code at one property? - Can I change the description of a hotel's turnaway reason? instructions: - text: Update turnaway codes at hotel {hotel} with {codes}. slots: hotel: path.hotelId codes: requestBody.turnAwayCodes - text: Change an existing property turnaway code for hotel {hotel}. slots: hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/turnawayCodes'].post update: x-apievangelist-phrasing: intent: Create a hotel turnaway code effect: write questions: - How do I add a new reason code for turned-away reservations at my hotel? - Can a single property create its own turnaway codes? instructions: - text: Create turnaway code {codes} at hotel {hotel}. slots: codes: requestBody.turnAwayCodes hotel: path.hotelId - text: Add a new property turnaway code for hotel {hotel}. slots: hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/turnawayCodes/{code}'].delete update: x-apievangelist-phrasing: intent: Delete a hotel turnaway code effect: destructive questions: - Can I delete a turnaway code from one property? - What is required to remove a hotel-level turnaway code? instructions: - text: Delete turnaway code {code} at hotel {hotel}. slots: code: path.code hotel: path.hotelId - text: Remove the property turnaway code {code} from hotel {hotel}. slots: code: path.code hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/upsellRules'].get update: x-apievangelist-phrasing: intent: List upsell rules effect: read questions: - What upgrade rules decide the upsell amount on reservations at my hotel? - Can I find upsell rules that apply to a given rate code or stay date? instructions: - text: List the upsell rules for hotel {hotel}. slots: hotel: path.hotelId - text: Show upsell rules for rate code {rate_code} at hotel {hotel}. slots: rate_code: query.rateCode hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/upsellRules'].put update: x-apievangelist-phrasing: intent: Modify an upsell rule effect: write questions: - How can I change an existing upgrade rule at my hotel? - Can I edit the upsell amount on a rule that already exists? instructions: - text: Modify the upsell rules at hotel {hotel} to {rules}. slots: hotel: path.hotelId rules: requestBody.upsellRules - text: Change an existing upgrade rule for hotel {hotel}. slots: hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/upsellRules'].post update: x-apievangelist-phrasing: intent: Create an upsell rule effect: write questions: - How do I create a room upgrade rule that applies at check-in? - Can I define a new upsell rule limited to certain date ranges? instructions: - text: Create upsell rule {rules} at hotel {hotel}. slots: rules: requestBody.upsellRules hotel: path.hotelId - text: Add a new room upgrade rule for hotel {hotel}. slots: hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/upsellRules/action/validate'].put update: x-apievangelist-phrasing: intent: Test whether an upsell rule works effect: read questions: - Can I test an upsell rule with a rate code and dates before relying on it? - What upsell does a rule return for a given set of reservation criteria? instructions: - text: Test the upsell rules at hotel {hotel} against {criteria}. slots: hotel: path.hotelId criteria: requestBody.criteria - text: Validate that my upgrade rule returns an upsell at hotel {hotel}. slots: hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/upsellRules/copy'].put update: x-apievangelist-phrasing: intent: Copy an upsell rule effect: write questions: - Can I copy an existing upsell rule to create a new one? - What is the easiest way to duplicate an upgrade rule? instructions: - text: Copy upsell rules {rules} at hotel {hotel}. slots: rules: requestBody.UpsellRules hotel: path.hotelId - text: Duplicate an existing upgrade rule at hotel {hotel}. slots: hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/upsellRules/{ruleCode}'].delete update: x-apievangelist-phrasing: intent: Delete an upsell rule effect: destructive questions: - How do I delete an upgrade rule from my hotel? - Can I remove one upsell rule by its rule code? instructions: - text: Delete upsell rule {rule} at hotel {hotel}. slots: rule: path.ruleCode hotel: path.hotelId - text: Remove the upgrade rule {rule} from hotel {hotel}. slots: rule: path.ruleCode hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/services/reservations/status'].get update: x-apievangelist-phrasing: intent: Check the reservation config service status effect: read questions: - Is the reservation configuration service up and responding? - How can I health-check the reservation config API? instructions: - text: Ping the reservation configuration service. - text: Check reservation config service status for hotel {hotel}. slots: hotel: header.x-hotelid method: generated generated: '2026-09-26' - target: $.paths['/templates/locatorCodes'].get update: x-apievangelist-phrasing: intent: List template locator codes effect: read questions: - Which locator codes are defined at the template level? - Can I list template locator codes including inactive ones? instructions: - text: List all template locator codes. - text: Show the template locator code {locator}. slots: locator: query.locatorCodes method: generated generated: '2026-09-26' - target: $.paths['/templates/locatorCodes'].put update: x-apievangelist-phrasing: intent: Update a template locator code effect: write questions: - How can I change a locator code in the template library? - Can I edit a template-level locator code? instructions: - text: Update template locator codes with {locators}. slots: locators: requestBody.locatorCodes - text: Change the template locator code definition {locators}. slots: locators: requestBody.locatorCodes method: generated generated: '2026-09-26' - target: $.paths['/templates/locatorCodes'].post update: x-apievangelist-phrasing: intent: Create a template locator code effect: write questions: - How do I add a locator code at the template level for properties to share? - Can I create a new template locator code? instructions: - text: Create template locator code {locators}. slots: locators: requestBody.locatorCodes - text: Add {locators} to the template locator codes. slots: locators: requestBody.locatorCodes method: generated generated: '2026-09-26' - target: $.paths['/templates/locatorCodes'].delete update: x-apievangelist-phrasing: intent: Delete template locator codes effect: destructive questions: - Can I delete a locator code from the templates? - What happens when I remove template-level locator codes? instructions: - text: Delete template locator code {locators}. slots: locators: query.locatorCodes - text: Remove the template locator codes {locators}. slots: locators: query.locatorCodes method: generated generated: '2026-09-26' - target: $.paths['/traceTexts'].get update: x-apievangelist-phrasing: intent: List trace texts effect: read questions: - Which standard trace texts are available for reservation, block and AR traces? - Can I list trace texts for one department and leave out global ones? instructions: - text: List trace texts for hotel {hotel_ids}. slots: hotel_ids: query.hotelIds - text: Show trace texts for department {department}. slots: department: query.departmentCodes method: generated generated: '2026-09-26' - target: $.paths['/traceTexts'].put update: x-apievangelist-phrasing: intent: Update a trace text effect: write questions: - How can I change the wording of an existing trace text? - Can I edit a trace text a department already uses? instructions: - text: Update trace texts with {trace_texts}. slots: trace_texts: requestBody.traceTexts - text: Change the existing trace text to {trace_texts}. slots: trace_texts: requestBody.traceTexts method: generated generated: '2026-09-26' - target: $.paths['/traceTexts'].post update: x-apievangelist-phrasing: intent: Create a trace text effect: write questions: - How do I set up the standard messages staff pick from when creating a trace? - Can I create new trace texts for a department? instructions: - text: Create trace texts {trace_texts}. slots: trace_texts: requestBody.traceTexts - text: 'Add a new standard trace message: {trace_texts}.' slots: trace_texts: requestBody.traceTexts method: generated generated: '2026-09-26' - target: $.paths['/traceTexts'].delete update: x-apievangelist-phrasing: intent: Delete a trace text effect: destructive questions: - Can I delete a trace text for a department? - What identifies which trace text gets removed? instructions: - text: Delete trace text {trace_text} for department {department} at hotel {hotel}. slots: trace_text: query.traceText department: query.departmentCode hotel: query.hotelId - text: Remove trace text {trace_text} at hotel {hotel}. slots: trace_text: query.traceText hotel: query.hotelId method: generated generated: '2026-09-26' - target: $.paths['/turnawayCodes'].get update: x-apievangelist-phrasing: intent: List turnaway code templates effect: read questions: - Which turnaway code templates exist for properties to inherit? - Can I search turnaway code templates with a wildcard? instructions: - text: List all turnaway code templates. - text: Show turnaway code template {codes}. slots: codes: query.codes method: generated generated: '2026-09-26' - target: $.paths['/turnawayCodes'].put update: x-apievangelist-phrasing: intent: Update a turnaway code template effect: write questions: - How can I edit a turnaway code template? - Can I change a template-level turnaway reason? instructions: - text: Update turnaway code templates with {codes}. slots: codes: requestBody.turnAwayCodes - text: Change the turnaway code template {codes}. slots: codes: requestBody.turnAwayCodes method: generated generated: '2026-09-26' - target: $.paths['/turnawayCodes'].post update: x-apievangelist-phrasing: intent: Create a turnaway code template effect: write questions: - How do I create a turnaway code at the template level? - Can I add a new template turnaway reason for all properties? instructions: - text: Create turnaway code template {codes}. slots: codes: requestBody.turnAwayCodes - text: Add {codes} to the turnaway code templates. slots: codes: requestBody.turnAwayCodes method: generated generated: '2026-09-26' - target: $.paths['/turnawayCodes/{turnawayCode}'].delete update: x-apievangelist-phrasing: intent: Delete a turnaway code template effect: destructive questions: - Can I delete a turnaway code template? - What is required to remove a template turnaway reason? instructions: - text: Delete turnaway code template {code}. slots: code: path.turnawayCode - text: Remove the template turnaway code {code}. slots: code: path.turnawayCode method: generated generated: '2026-09-26' - target: $.paths['/upsert/hotels/{hotelId}/autoAttachElements'].put update: x-apievangelist-phrasing: intent: Create or update auto attach element rules effect: write questions: - Can I create an auto attach rule or update it if it already exists in one call? - Is there an upsert for auto attach element rules? instructions: - text: Upsert auto attach rules {rules} at hotel {hotel}. slots: rules: requestBody.autoAttachRules hotel: path.hotelId - text: Create or update the auto attach element rules for hotel {hotel}. slots: hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/upsert/hotels/{hotelId}/ecoupons'].put update: x-apievangelist-phrasing: intent: Create or update eCoupon codes effect: write questions: - Can I create an eCoupon or update it if it already exists in one request? - Is there an upsert for eCoupon codes? instructions: - text: Upsert eCoupon codes {ecoupons} at hotel {hotel}. slots: ecoupons: requestBody.eCouponCodes hotel: path.hotelId - text: Create or update the eCoupons for hotel {hotel}. slots: hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/upsert/hotels/{hotelId}/globalAlerts'].put update: x-apievangelist-phrasing: intent: Create or update global alerts effect: write questions: - Can I create a global alert or update it if it already exists in one call? - Is there an upsert for a hotel's global alerts? instructions: - text: Upsert global alerts {global_alerts} at hotel {hotel}. slots: global_alerts: requestBody.globalAlerts hotel: path.hotelId - text: Create or update the global alerts for hotel {hotel}. slots: hotel: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/upsert/hotels/{hotelId}/upsellRules'].put update: x-apievangelist-phrasing: intent: Create or update upsell rules effect: write questions: - Can I create an upgrade rule or modify it if it already exists in one request? - Is there an upsert for upsell rules? instructions: - text: Upsert upsell rules {rules} at hotel {hotel}. slots: rules: requestBody.upsellRules hotel: path.hotelId - text: Create or update the upgrade rules for hotel {hotel}. slots: hotel: path.hotelId method: generated generated: '2026-09-26'