API Evangelist conversational phrasing for OPERA Cloud Event Configuration Resource 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 OPERA Cloud Event Configuration Resource Config API
  version: 1.0.0
extends: openapi/oracle-hospitality-resourceconfig-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: 88
- target: $.paths['/EventForecasts/copy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy event forecasts to another property
      effect: write
      questions:
      - Can I copy an event forecast from one property to another instead of rebuilding it?
      - What criteria do I pass to duplicate event forecasts across hotels?
      instructions:
      - text: Copy event forecasts using criteria {criteria}.
        slots:
          criteria: requestBody.criteria
      - text: Duplicate our event revenue forecasts into the target property described in {criteria}.
        slots:
          criteria: requestBody.criteria
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringContainers'].get
  update:
    x-apievangelist-phrasing:
      intent: List menu item catering containers
      effect: read
      questions:
      - Which catering container codes, like per dozen or per piece, are set up?
      - Can I include inactive catering containers when I list them?
      instructions:
      - text: List all catering container codes.
      - text: Find catering containers whose description matches {description}, including inactive ones if {fetchInactive}.
        slots:
          description: query.description
          fetchInactive: query.fetchInactive
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringContainers'].post
  update:
    x-apievangelist-phrasing:
      intent: Create menu item catering containers
      effect: write
      questions:
      - How do I define a new unit a menu item is sold in, like per dozen?
      - Can I add several catering container codes in one call?
      instructions:
      - text: Create catering containers {containers}.
        slots:
          containers: requestBody.containers
      - text: 'Add a new catering container code for items sold per piece: {containers}.'
        slots:
          containers: requestBody.containers
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringContainers/{cateringContainersCode}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a catering container code
      effect: write
      questions:
      - Can I rename or change the description of an existing catering container code?
      - What do I send to edit a menu item container that already exists?
      instructions:
      - text: Update catering container {cateringContainersCode} with {containers}.
        slots:
          cateringContainersCode: path.cateringContainersCode
          containers: requestBody.containers
      - text: Change the settings of existing catering container code {cateringContainersCode}.
        slots:
          cateringContainersCode: path.cateringContainersCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringContainers/{cateringContainersCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a catering container code
      effect: destructive
      questions:
      - Can I remove a catering container code we no longer sell menu items in?
      - Is deleting a menu item container code permanent?
      instructions:
      - text: Delete catering container {cateringContainersCode}.
        slots:
          cateringContainersCode: path.cateringContainersCode
      - text: Remove the menu item container code {cateringContainersCode}.
        slots:
          cateringContainersCode: path.cateringContainersCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringItemRates'].get
  update:
    x-apievangelist-phrasing:
      intent: List catering item rate codes
      effect: read
      questions:
      - What catering item rate codes are configured?
      - Can I search catering item rates with a wildcard on the code?
      instructions:
      - text: List all catering item rates.
      - text: Get catering item rates for codes {codes}.
        slots:
          codes: query.codes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringItemRates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create catering item rate codes
      effect: write
      questions:
      - How do I set up a new catering item rate code?
      - Can I create multiple catering item rates in one request?
      instructions:
      - text: Create catering item rates {itemRates}.
        slots:
          itemRates: requestBody.itemRates
      - text: Add a new catering item rate code defined as {itemRates}.
        slots:
          itemRates: requestBody.itemRates
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringItemRates/{cateringItemRatesCode}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a catering item rate code
      effect: write
      questions:
      - Can I change an existing catering item rate code's details?
      - What's needed to edit a catering item rate that is already in use?
      instructions:
      - text: Update catering item rate {cateringItemRatesCode} with {itemRates}.
        slots:
          cateringItemRatesCode: path.cateringItemRatesCode
          itemRates: requestBody.itemRates
      - text: Change the existing catering item rate code {cateringItemRatesCode}.
        slots:
          cateringItemRatesCode: path.cateringItemRatesCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringItemRates/{cateringItemRatesCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a catering item rate code
      effect: destructive
      questions:
      - Can I get rid of a catering item rate code we no longer charge?
      - Is there a way to delete one catering item rate by its code?
      instructions:
      - text: Delete catering item rate {cateringItemRatesCode}.
        slots:
          cateringItemRatesCode: path.cateringItemRatesCode
      - text: Remove the catering item rate code {cateringItemRatesCode}.
        slots:
          cateringItemRatesCode: path.cateringItemRatesCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringMenuClasses'].put
  update:
    x-apievangelist-phrasing:
      intent: Update catering menu classes
      effect: write
      questions:
      - Can I edit several existing catering menu classes in one request?
      - What do I send to change a menu class that already exists?
      instructions:
      - text: Update the existing catering menu classes with {menuClassList}.
        slots:
          menuClassList: requestBody.menuClassList
      - text: Change our current menu class definitions to {menuClassList}.
        slots:
          menuClassList: requestBody.menuClassList
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringMenuClasses'].post
  update:
    x-apievangelist-phrasing:
      intent: Create catering menu classes
      effect: write
      questions:
      - How do I add a new menu class, like breakfast or dinner, for catering?
      - Can I create several new catering menu classes at once?
      instructions:
      - text: Create new catering menu classes {menuClassList}.
        slots:
          menuClassList: requestBody.menuClassList
      - text: 'Add a brand-new menu class for banquet menus: {menuClassList}.'
        slots:
          menuClassList: requestBody.menuClassList
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringMenuItemClasses'].post
  update:
    x-apievangelist-phrasing:
      intent: Create catering menu item classes
      effect: write
      questions:
      - Can I create new classes to group individual catering menu items?
      - What do I send to add a new menu item class such as beverages?
      instructions:
      - text: Create new menu item classes {menuItemClasses}.
        slots:
          menuItemClasses: requestBody.menuItemClasses
      - text: 'Add a beverages menu item class: {menuItemClasses}.'
        slots:
          menuItemClasses: requestBody.menuItemClasses
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringMenuItemClasses/{cateringMenuItemClassesCode}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a catering menu item class
      effect: write
      questions:
      - Can I change an existing menu item class by its code?
      - What fields of a menu item class can I edit after it's created?
      instructions:
      - text: Update menu item class {cateringMenuItemClassesCode} with {menuItemClasses}.
        slots:
          cateringMenuItemClassesCode: path.cateringMenuItemClassesCode
          menuItemClasses: requestBody.menuItemClasses
      - text: Edit the existing menu item class {cateringMenuItemClassesCode}.
        slots:
          cateringMenuItemClassesCode: path.cateringMenuItemClassesCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringMenuItemClasses/{cateringMenuItemClassesCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a catering menu item class
      effect: destructive
      questions:
      - Can I remove a menu item class we no longer use?
      - Does deleting a menu item class require its unique ID type?
      instructions:
      - text: Delete menu item class {cateringMenuItemClassesCode}.
        slots:
          cateringMenuItemClassesCode: path.cateringMenuItemClassesCode
      - text: Remove menu item class {cateringMenuItemClassesCode} with ID type {menuItemClassesUniqueIdType}.
        slots:
          cateringMenuItemClassesCode: path.cateringMenuItemClassesCode
          menuItemClassesUniqueIdType: query.menuItemClassesUniqueIdType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringMenuItemClasses/{cateringMenuItemClassesCode}/copy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy a catering menu item class
      effect: write
      questions:
      - Can I duplicate an existing menu item class instead of recreating it?
      - Where would I copy a menu item class to another property?
      instructions:
      - text: Copy menu item class {cateringMenuItemClassesCode} using {copyMenuItemClasses}.
        slots:
          cateringMenuItemClassesCode: path.cateringMenuItemClassesCode
          copyMenuItemClasses: requestBody.copyMenuItemClasses
      - text: Duplicate the menu item class {cateringMenuItemClassesCode}.
        slots:
          cateringMenuItemClassesCode: path.cateringMenuItemClassesCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringMenuItems/{cateringMenuItemId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a catering menu item at chain level
      effect: destructive
      questions:
      - Can I delete a catering menu item by ID without going through a specific hotel path?
      - Is there a chain-level way to remove a menu item and optionally name the hotel as a filter?
      instructions:
      - text: Remove catering menu item {cateringMenuItemId} at the chain level.
        slots:
          cateringMenuItemId: path.cateringMenuItemId
      - text: Use the chain endpoint to delete menu item {cateringMenuItemId}, scoped by hotel {hotelId}.
        slots:
          cateringMenuItemId: path.cateringMenuItemId
          hotelId: query.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringPackageResources'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a resource from a catering package event
      effect: destructive
      questions:
      - Can I remove a single resource, like a menu or item, from a catering package event?
      - What identifiers do I need to delete a catering package resource?
      instructions:
      - text: Delete resource {resourceId} from package event {pkgEventId} ({pkgEventIdType}) at hotel {hotelId}.
        slots:
          resourceId: query.resourceId
          pkgEventId: query.pkgEventId
          pkgEventIdType: query.pkgEventIdType
          hotelId: query.hotelId
      - text: Take resource {resourceId} off catering package event {pkgEventId}, ID type {pkgEventIdType}, hotel {hotelId}.
        slots:
          resourceId: query.resourceId
          pkgEventId: query.pkgEventId
          pkgEventIdType: query.pkgEventIdType
          hotelId: query.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringPackages'].get
  update:
    x-apievangelist-phrasing:
      intent: Search catering packages across properties
      effect: read
      questions:
      - Which catering packages exist across several of our hotels?
      - Can I find web-bookable catering packages across properties for a given attendee count?
      instructions:
      - text: Search catering packages across hotels {hotelIds}.
        slots:
          hotelIds: query.hotelIds
      - text: Find packages in hotels {hotelIds} that fit at least {minAttendees} attendees.
        slots:
          hotelIds: query.hotelIds
          minAttendees: query.minAttendees
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringPackages/{cateringPackageId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a catering package at chain level
      effect: read
      questions:
      - Can I look up a catering package by ID without specifying the hotel in the path?
      - Is there a chain-wide lookup for one catering package's details?
      instructions:
      - text: Get catering package {cateringPackageId} from the chain level.
        slots:
          cateringPackageId: path.cateringPackageId
      - text: Use the chain lookup to fetch package {cateringPackageId} with instructions {fetchInstructions}.
        slots:
          cateringPackageId: path.cateringPackageId
          fetchInstructions: query.fetchInstructions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringServings'].get
  update:
    x-apievangelist-phrasing:
      intent: List catering serving codes
      effect: read
      questions:
      - What catering serving codes are configured?
      - Can I search catering servings by description?
      instructions:
      - text: List all catering servings.
      - text: Get catering servings for codes {servingCodes}.
        slots:
          servingCodes: query.servingCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cateringServings/{cateringServingsCode}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a catering serving code
      effect: write
      questions:
      - Can I change the details of an existing catering serving code?
      - What do I send to edit a catering serving style?
      instructions:
      - text: Update catering serving {cateringServingsCode} with {servings}.
        slots:
          cateringServingsCode: path.cateringServingsCode
          servings: requestBody.servings
      - text: Edit serving code {cateringServingsCode}.
        slots:
          cateringServingsCode: path.cateringServingsCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/eventForecasts'].put
  update:
    x-apievangelist-phrasing:
      intent: Update existing event forecasts
      effect: write
      questions:
      - Can I change the revenue figures on an event forecast that already exists?
      - What's the way to edit a property's current event forecast?
      instructions:
      - text: Update the existing event forecasts with {eventForecasts}.
        slots:
          eventForecasts: requestBody.eventForecasts
      - text: Revise our current event forecast amounts to {eventForecasts}.
        slots:
          eventForecasts: requestBody.eventForecasts
      method: generated
      generated: '2026-09-26'
- target: $.paths['/eventForecasts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create event forecasts
      effect: write
      questions:
      - How do I set up a new revenue forecast for a type of event booking?
      - Can a new event forecast be tied to a market code or block type?
      instructions:
      - text: Create new event forecasts {eventForecasts}.
        slots:
          eventForecasts: requestBody.eventForecasts
      - text: 'Define a brand-new event forecast by market code: {eventForecasts}.'
        slots:
          eventForecasts: requestBody.eventForecasts
      method: generated
      generated: '2026-09-26'
- target: $.paths['/eventForecasts/{forecastsId}/eventTypes/{eventTypesCode}/eventForecasts'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an event forecast
      effect: destructive
      questions:
      - Can I remove an event forecast for one event type?
      - Which forecast and event type identifiers do I need to delete a forecast?
      instructions:
      - text: Delete event forecast {forecastsId} for event type {eventTypesCode}.
        slots:
          forecastsId: path.forecastsId
          eventTypesCode: path.eventTypesCode
      - text: Remove forecast {forecastsId} for event type {eventTypesCode} at hotel {hotelId}.
        slots:
          forecastsId: path.forecastsId
          eventTypesCode: path.eventTypesCode
          hotelId: query.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringMenuClasses'].get
  update:
    x-apievangelist-phrasing:
      intent: List a property's catering menu classes
      effect: read
      questions:
      - Which menu classes are set up for catering at a hotel?
      - Can I include the menus inside each menu class when I list them?
      instructions:
      - text: List the catering menu classes for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Show web-bookable menu classes at hotel {hotelId} with their menus.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringMenuItemClasses'].get
  update:
    x-apievangelist-phrasing:
      intent: List a property's menu item classes
      effect: read
      questions:
      - What menu item classes does a property have for catering?
      - Can I list menu item classes together with the items in each class?
      instructions:
      - text: List menu item classes for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Get menu item classes named {className} at hotel {hotelId}, including their menu items.
        slots:
          className: query.className
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringMenuItems'].get
  update:
    x-apievangelist-phrasing:
      intent: List a property's catering menu items
      effect: read
      questions:
      - Which individual menu items can we sell for catering at this hotel?
      - Can I search menu items by quick insert code or name?
      instructions:
      - text: List catering menu items for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Find menu items named {name} at hotel {hotelId}.
        slots:
          name: query.name
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringMenuItems'].post
  update:
    x-apievangelist-phrasing:
      intent: Create catering menu items
      effect: write
      questions:
      - How do I add new menu items to a hotel's catering setup?
      - Can I create several menu items for a property in one request?
      instructions:
      - text: Create menu items {cateringMenuItems} at hotel {hotelId}.
        slots:
          cateringMenuItems: requestBody.cateringMenuItems
          hotelId: path.hotelId
      - text: Add new catering menu items to hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringMenuItems/copy'].post
  update:
    x-apievangelist-phrasing:
      intent: Copy catering menu items
      effect: write
      questions:
      - Can I copy menu items from one hotel to another?
      - Is there a way to duplicate catering menu items rather than re-enter them?
      instructions:
      - text: Copy catering menu items from hotel {hotelId} using {copyMenuItems}.
        slots:
          hotelId: path.hotelId
          copyMenuItems: requestBody.copyMenuItems
      - text: Duplicate menu items at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringMenuItems/{cateringMenuItemId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a catering menu item
      effect: write
      questions:
      - Can I change the price or name of one existing catering menu item?
      - What do I send to edit a specific menu item at a hotel?
      instructions:
      - text: Update menu item {cateringMenuItemId} at hotel {hotelId} with {cateringMenuItems}.
        slots:
          cateringMenuItemId: path.cateringMenuItemId
          hotelId: path.hotelId
          cateringMenuItems: requestBody.cateringMenuItems
      - text: Edit catering menu item {cateringMenuItemId} for hotel {hotelId}.
        slots:
          cateringMenuItemId: path.cateringMenuItemId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringMenuItems/{cateringMenuItemId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a catering menu item from a property
      effect: destructive
      questions:
      - Can I delete one menu item from a specific hotel's catering setup?
      - Is removing a property's menu item permanent?
      instructions:
      - text: Delete menu item {cateringMenuItemId} from hotel {hotelId}.
        slots:
          cateringMenuItemId: path.cateringMenuItemId
          hotelId: path.hotelId
      - text: Remove catering menu item {cateringMenuItemId} at property {hotelId}.
        slots:
          cateringMenuItemId: path.cateringMenuItemId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/upsert/hotels/{hotelId}/cateringMenuItems'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update catering menu items
      effect: write
      questions:
      - Can I upsert menu items so new ones are created and existing ones updated in one call?
      - Is there a create-or-update option for a hotel's catering menu items?
      instructions:
      - text: Upsert menu items {cateringMenuItems} at hotel {hotelId}.
        slots:
          cateringMenuItems: requestBody.cateringMenuItems
          hotelId: path.hotelId
      - text: Create or update catering menu items for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringMenus'].get
  update:
    x-apievangelist-phrasing:
      intent: List a property's catering menus
      effect: read
      questions:
      - Which catering menus does a hotel offer?
      - Can I filter menus by dietary code or event type?
      - What menus are web-bookable within a date range?
      instructions:
      - text: List catering menus for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Find menus at hotel {hotelId} for event types {eventTypesCodes}.
        slots:
          hotelId: path.hotelId
          eventTypesCodes: query.eventTypesCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringMenus'].post
  update:
    x-apievangelist-phrasing:
      intent: Create catering menus
      effect: write
      questions:
      - How do I create a new banquet menu for a property?
      - Can I add several new menus to a hotel at once?
      instructions:
      - text: Create menus {menuList} at hotel {hotelId}.
        slots:
          menuList: requestBody.menuList
          hotelId: path.hotelId
      - text: Add a new catering menu to hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringMenus/{cateringMenuId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a catering menu's details
      effect: read
      questions:
      - What's included in one specific catering menu?
      - Can I view an inactive menu's details by its ID?
      instructions:
      - text: Show catering menu {cateringMenuId} at hotel {hotelId}.
        slots:
          cateringMenuId: path.cateringMenuId
          hotelId: path.hotelId
      - text: Get the details of menu {cateringMenuId} for hotel {hotelId}, even if inactive.
        slots:
          cateringMenuId: path.cateringMenuId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringMenus/{cateringMenuId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a catering menu
      effect: write
      questions:
      - Can I change the items or price on an existing catering menu?
      - What do I send to edit one menu at a hotel?
      instructions:
      - text: Update menu {cateringMenuId} at hotel {hotelId} with {menuList}.
        slots:
          cateringMenuId: path.cateringMenuId
          hotelId: path.hotelId
          menuList: requestBody.menuList
      - text: Edit catering menu {cateringMenuId} for hotel {hotelId}.
        slots:
          cateringMenuId: path.cateringMenuId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringMenus/{cateringMenuId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a catering menu
      effect: destructive
      questions:
      - Can I remove a banquet menu from a property?
      - Is deleting a catering menu reversible?
      instructions:
      - text: Delete menu {cateringMenuId} from hotel {hotelId}.
        slots:
          cateringMenuId: path.cateringMenuId
          hotelId: path.hotelId
      - text: Remove catering menu {cateringMenuId} at property {hotelId}.
        slots:
          cateringMenuId: path.cateringMenuId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringMenus/{cateringMenuId}/copy'].post
  update:
    x-apievangelist-phrasing:
      intent: Copy a catering menu
      effect: write
      questions:
      - Can I make a copy of an existing menu to use as a starting point?
      - Is there a way to clone a banquet menu at a property?
      instructions:
      - text: Copy menu {cateringMenuId} at hotel {hotelId}.
        slots:
          cateringMenuId: path.cateringMenuId
          hotelId: path.hotelId
      - text: Clone catering menu {cateringMenuId} for hotel {hotelId} using {copyCateringMenus}.
        slots:
          cateringMenuId: path.cateringMenuId
          hotelId: path.hotelId
          copyCateringMenus: requestBody.copyCateringMenus
      method: generated
      generated: '2026-09-26'
- target: $.paths['/upsert/hotels/{hotelId}/cateringMenus'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update catering menus
      effect: write
      questions:
      - Can I upsert a batch of menus, creating new ones and updating existing ones?
      - Is there one call that creates or changes a property's catering menus?
      instructions:
      - text: Upsert menus {menuList} at hotel {hotelId}.
        slots:
          menuList: requestBody.menuList
          hotelId: path.hotelId
      - text: Create or update the catering menus for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringPackages'].get
  update:
    x-apievangelist-phrasing:
      intent: List a property's catering packages
      effect: read
      questions:
      - What catering packages and templates does one hotel have?
      - Can I find a hotel's packages sellable on a given date?
      instructions:
      - text: List catering packages for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Find packages at hotel {hotelId} with package code {packageCode}.
        slots:
          hotelId: path.hotelId
          packageCode: query.packageCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringPackages'].post
  update:
    x-apievangelist-phrasing:
      intent: Create catering packages
      effect: write
      questions:
      - How do I set up a pre-configured catering package for events?
      - Can I create a catering template with resources typically used for events?
      instructions:
      - text: Create catering packages {cateringPackageList} at hotel {hotelId}.
        slots:
          cateringPackageList: requestBody.cateringPackageList
          hotelId: path.hotelId
      - text: Add a new event package to hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringPackages/{cateringPackageId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a property's catering package
      effect: read
      questions:
      - What resources and prices are in a specific hotel's catering package?
      - Can I see one package's details including instructions?
      instructions:
      - text: Show catering package {cateringPackageId} at hotel {hotelId}.
        slots:
          cateringPackageId: path.cateringPackageId
          hotelId: path.hotelId
      - text: Get package {cateringPackageId} for hotel {hotelId} with ID type {pkgIDType}.
        slots:
          cateringPackageId: path.cateringPackageId
          hotelId: path.hotelId
          pkgIDType: query.pkgIDType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringPackages/{cateringPackageId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a catering package
      effect: write
      questions:
      - Can I change an existing catering package's details?
      - What do I send to modify one package at a hotel?
      instructions:
      - text: Update catering package {cateringPackageId} at hotel {hotelId} with {cateringPackageList}.
        slots:
          cateringPackageId: path.cateringPackageId
          hotelId: path.hotelId
          cateringPackageList: requestBody.cateringPackageList
      - text: Edit package {cateringPackageId} for hotel {hotelId}.
        slots:
          cateringPackageId: path.cateringPackageId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cateringPackages/{cateringPackageId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a catering package
      effect: destructive
      questions:
      - Can I remove a whole catering package from a property?
      - Is deleting a package permanent?
      instructions:
      - text: Delete catering package {cateringPackageId} at hotel {hotelId}.
        slots:
          cateringPackageId: path.cateringPackageId
          hotelId: path.hotelId
      - text: Remove the entire package {cateringPackageId} from hotel {hotelId}.
        slots:
          cateringPackageId: path.cateringPackageId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'


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