API Evangelist conversational phrasing for OPERA Cloud Sales Event Management 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 Sales Event Management API
  version: 1.0.0
extends: openapi/oracle-hospitality-event-management-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 45
- target: $.paths['/alternateEvents'].put
  update:
    x-apievangelist-phrasing:
      intent: Manage alternate catering events
      effect: write
      questions:
      - How do I mark one catering event as an alternate to another event?
      - Can I promote or reshuffle the alternate events set up as backups for a function?
      instructions:
      - text: 'Apply these alternate event changes: {alternateEvents}.'
        slots:
          alternateEvents: requestBody.alternateEvents
      - text: Run the alternate-event instruction {instruction} on the listed events.
        slots:
          instruction: requestBody.manageAlternateEventsInstruction
      method: generated
      generated: '2026-10-01'
- target: $.paths['/blocks/{blockId}/cateringPackages'].get
  update:
    x-apievangelist-phrasing:
      intent: List catering packages on a block
      effect: read
      questions:
      - Which catering packages are already booked on this group block?
      - What catering packages does a block currently carry in OPERA Cloud?
      instructions:
      - text: Show the catering packages on block {blockId}.
        slots:
          blockId: path.blockId
      - text: List catering packages for block {blockId} at hotel {hotelId}.
        slots:
          blockId: path.blockId
          hotelId: query.hotelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/blocks/{blockId}/cateringPackages'].put
  update:
    x-apievangelist-phrasing:
      intent: Update catering packages already on a block
      effect: write
      questions:
      - Can I edit a catering package that is already attached to a block?
      - How do I change the details of existing catering packages on a group booking?
      instructions:
      - text: Update the existing catering packages on block {blockId} with {cateringPackageList}.
        slots:
          blockId: path.blockId
          cateringPackageList: requestBody.cateringPackageList
      - text: Edit the catering packages already booked on block {blockId}.
        slots:
          blockId: path.blockId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/blocks/{blockId}/cateringPackages'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a catering package to a block
      effect: write
      questions:
      - How do I add an available catering package onto a group block?
      - Can I book a new catering package onto a block that has none yet?
      instructions:
      - text: Add a catering package to block {blockId} using {criteria}.
        slots:
          blockId: path.blockId
          criteria: requestBody.criteria
      - text: Book a new catering package onto block {blockId}.
        slots:
          blockId: path.blockId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/blocks/{blockId}/cateringPackages/{cateringpackageId}/copy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy a catering package to another date
      effect: write
      questions:
      - Can I duplicate a catering package onto another day of the same block?
      - How do I repeat a catering package on a different date without re-entering it?
      instructions:
      - text: Copy catering package {cateringpackageId} on block {blockId} to another date.
        slots:
          cateringpackageId: path.cateringpackageId
          blockId: path.blockId
      - text: Duplicate package {cateringpackageId} on block {blockId} using {criteria}.
        slots:
          cateringpackageId: path.cateringpackageId
          blockId: path.blockId
          criteria: requestBody.criteria
      method: generated
      generated: '2026-10-01'
- target: $.paths['/blocks/{blockId}/cateringPackages/{cateringpackageId}/revenue'].get
  update:
    x-apievangelist-phrasing:
      intent: Get revenue for a catering package
      effect: read
      questions:
      - How much revenue is a specific catering package on a block bringing in?
      - What revenue lines are recorded against one catering package?
      instructions:
      - text: Show revenue for catering package {cateringpackageId} on block {blockId}.
        slots:
          cateringpackageId: path.cateringpackageId
          blockId: path.blockId
      - text: Get the catering package {cateringpackageId} revenue breakdown for hotel {hotelId}.
        slots:
          cateringpackageId: path.cateringpackageId
          hotelId: query.hotelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/blocks/{blockId}/cateringPackages/{cateringpackageId}/revenue'].post
  update:
    x-apievangelist-phrasing:
      intent: Add revenue to a catering package
      effect: write
      questions:
      - How do I record new revenue against a catering package on a block?
      - Can I add revenue details to a package that has none yet?
      instructions:
      - text: Add revenue {cateringPackageRevenueDetails} to package {cateringpackageId} on block {blockId}.
        slots:
          cateringPackageRevenueDetails: requestBody.cateringPackageRevenueDetails
          cateringpackageId: path.cateringpackageId
          blockId: path.blockId
      - text: Record new revenue for catering package {cateringpackageId} on block {blockId}.
        slots:
          cateringpackageId: path.cateringpackageId
          blockId: path.blockId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/blocks/{blockId}/events/{eventId}/resources/copy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy event resources to other events
      effect: write
      questions:
      - Can I copy the menus and items from one event to several other events?
      - How do I reuse an event's resources on events in a different block?
      instructions:
      - text: Copy the resources from event {eventId} on block {blockId} to other events.
        slots:
          eventId: path.eventId
          blockId: path.blockId
      - text: Copy resources of event {eventId} on block {blockId} using {criteria}.
        slots:
          eventId: path.eventId
          blockId: path.blockId
          criteria: requestBody.criteria
      method: generated
      generated: '2026-10-01'
- target: $.paths['/blocks/{blockId}/events/{eventId}/resources/move'].put
  update:
    x-apievangelist-phrasing:
      intent: Move event resources to another event
      effect: write
      questions:
      - How do I move menus or items off one event and onto another event?
      - Can resources be transferred to an event in a different block rather than copied?
      instructions:
      - text: Move resources from event {eventId} on block {blockId} to another event.
        slots:
          eventId: path.eventId
          blockId: path.blockId
      - text: Transfer event {eventId} resources on block {blockId} using {criteria}.
        slots:
          eventId: path.eventId
          blockId: path.blockId
          criteria: requestBody.criteria
      method: generated
      generated: '2026-10-01'
- target: $.paths['/blocks/{blockId}/events/{eventId}/resources/{resourceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one resource on an event
      effect: read
      questions:
      - What are the details of a single menu or item booked on an event?
      - Can I look up one specific resource on a catering event by its ID?
      instructions:
      - text: Get resource {resourceId} on event {eventId} of block {blockId}.
        slots:
          resourceId: path.resourceId
          eventId: path.eventId
          blockId: path.blockId
      - text: Show the menu resource {resourceId} booked on event {eventId} for block {blockId}.
        slots:
          resourceId: path.resourceId
          eventId: path.eventId
          blockId: path.blockId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/cateringEvents'].put
  update:
    x-apievangelist-phrasing:
      intent: Update several catering events at once
      effect: write
      questions:
      - Can I update many catering events on the same block in one request?
      - How do I bulk-change a batch of events for one group?
      instructions:
      - text: 'Bulk update these catering events on the block: {cateringEventsBulkUpdate}.'
        slots:
          cateringEventsBulkUpdate: requestBody.cateringEventsBulkUpdate
      - text: Apply the same change to all the catering events I list for this block.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/cateringPackagesRevenue'].put
  update:
    x-apievangelist-phrasing:
      intent: Update catering package revenue
      effect: write
      questions:
      - How do I correct revenue already recorded on a catering package?
      - Can I adjust existing catering package revenue on a block?
      instructions:
      - text: Update the catering package revenue to {cateringPackageRevenueDetails}.
        slots:
          cateringPackageRevenueDetails: requestBody.cateringPackageRevenueDetails
      - text: Change the recorded revenue on this block's catering package.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/cateringPackagesRevenue'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete catering package revenue
      effect: destructive
      questions:
      - How do I remove a revenue line from a catering package event?
      - Can I delete one revenue type from a catering package without removing the package?
      instructions:
      - text: Delete revenue type {cateringPackageRevenueType} from catering package event {cateringPackageEventId}.
        slots:
          cateringPackageRevenueType: query.cateringPackageRevenueType
          cateringPackageEventId: query.cateringPackageEventId
      - text: Remove the catering package revenue for event {cateringPackageEventId} at hotel {hotelId}.
        slots:
          cateringPackageEventId: query.cateringPackageEventId
          hotelId: query.hotelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/eventResource'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a resource on an event
      effect: write
      questions:
      - How do I change a single menu or item that's already booked on an event?
      - Can I edit one event resource by giving the block and event IDs in the body?
      instructions:
      - text: Update this event resource with {eventResourceDetails}.
        slots:
          eventResourceDetails: requestBody.eventResourceDetails
      - text: Change the quantity on a single booked event resource.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/eventcalendar'].get
  update:
    x-apievangelist-phrasing:
      intent: View the event calendar across hotels
      effect: read
      questions:
      - Can I see one event calendar covering several of our properties at once?
      - Which function spaces are booked across multiple hotels next week?
      instructions:
      - text: Show the event calendar for hotels {hotelIds} from {eventStartDate} to {eventEndDate}.
        slots:
          hotelIds: query.hotelIds
          eventStartDate: query.eventStartDate
          eventEndDate: query.eventEndDate
      - text: Show the multi-property event calendar for hotels {hotelIds}, including opportunities.
        slots:
          hotelIds: query.hotelIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/events'].get
  update:
    x-apievangelist-phrasing:
      intent: Search catering events across hotels
      effect: read
      questions:
      - Which catering events are booked across all our hotels in a date range?
      - Can I find events by name or status across several properties?
      instructions:
      - text: Find catering events at hotels {hotelIds} between {eventStartDate} and {eventEndDate}.
        slots:
          hotelIds: query.hotelIds
          eventStartDate: query.eventStartDate
          eventEndDate: query.eventEndDate
      - text: Search events named {name} across hotels {hotelIds}.
        slots:
          name: query.name
          hotelIds: query.hotelIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/events'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a catering event
      effect: write
      questions:
      - How do I create a new catering event like a lunch or meeting in OPERA Cloud?
      - Can I book a new function event through the API?
      instructions:
      - text: Create a catering event with {eventDetails}.
        slots:
          eventDetails: requestBody.eventDetails
      - text: Book a new reception event for the group.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/events'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several events at once
      effect: destructive
      questions:
      - Can I delete a whole list of catering events in one call?
      - How do I remove multiple events and their sub-events together?
      instructions:
      - text: Delete events {eventIds}.
        slots:
          eventIds: query.eventIds
      - text: Delete events {eventIds} at hotels {hotelIds} including their sub-events.
        slots:
          eventIds: query.eventIds
          hotelIds: query.hotelIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/events/{eventId}/splitQuantity'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an event item's split quantity
      effect: read
      questions:
      - How is an item's quantity split across the time of an event?
      - What split quantity is set for an event item on a given day?
      instructions:
      - text: Show the item split quantity for event {eventId}.
        slots:
          eventId: path.eventId
      - text: Get split quantity of item {itemId} on event {eventId} for {eventStartDate}.
        slots:
          itemId: query.itemId
          eventId: path.eventId
          eventStartDate: query.eventStartDate
      method: generated
      generated: '2026-10-01'
- target: $.paths['/eventsResources'].put
  update:
    x-apievangelist-phrasing:
      intent: Update event resources at chain level
      effect: write
      questions:
      - Can I update event items and menus without specifying a hotel in the path?
      - How do I change event resources through the chain-wide endpoint?
      instructions:
      - text: Update event menus {eventMenus} through the chain-level resources endpoint.
        slots:
          eventMenus: requestBody.eventMenus
      - text: Change chain-wide event items to {eventItems}.
        slots:
          eventItems: requestBody.eventItems
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/block/{blockId}/resourceEvents'].get
  update:
    x-apievangelist-phrasing:
      intent: List a block's events that use a resource
      effect: read
      questions:
      - Which events on a block have a particular resource booked?
      - Can I list a block's events and filter them to one resource?
      instructions:
      - text: List events on block {blockId} at hotel {hotelId}.
        slots:
          blockId: path.blockId
          hotelId: path.hotelId
      - text: Find events on block {blockId} at hotel {hotelId} that use resource {resourceId}.
        slots:
          blockId: path.blockId
          hotelId: path.hotelId
          resourceId: query.resourceId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/blocks/{blockId}/cateringEvents/copy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy a catering event to new dates
      effect: write
      questions:
      - Can I repeat a lunch event on the following days of the same block?
      - How do I copy an existing catering event to new dates?
      instructions:
      - text: Copy the catering event on block {blockId} at hotel {hotelId} to new dates.
        slots:
          blockId: path.blockId
          hotelId: path.hotelId
      - text: Copy catering events on block {blockId} at hotel {hotelId} using {criteria}.
        slots:
          blockId: path.blockId
          hotelId: path.hotelId
          criteria: requestBody.criteria
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/blocks/{blockId}/cateringPackages'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove several catering packages from a block
      effect: destructive
      questions:
      - Can I remove several catering packages from a block in one go?
      - How do I delete a list of packages from a group booking?
      instructions:
      - text: Remove catering packages {cateringPackageId} from block {blockId} at hotel {hotelId}.
        slots:
          cateringPackageId: query.cateringPackageId
          blockId: path.blockId
          hotelId: path.hotelId
      - text: Delete the listed catering packages {cateringPackageId} from block {blockId}.
        slots:
          cateringPackageId: query.cateringPackageId
          blockId: path.blockId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/blocks/{blockId}/cateringPackages/{cateringPackageId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove one catering package from a block
      effect: destructive
      questions:
      - How do I delete a single catering package from a block by its ID?
      - What happens if I take one package off a block?
      instructions:
      - text: Delete catering package {cateringPackageId} from block {blockId} at hotel {hotelId}.
        slots:
          cateringPackageId: path.cateringPackageId
          blockId: path.blockId
          hotelId: path.hotelId
      - text: Take package {cateringPackageId} off block {blockId}.
        slots:
          cateringPackageId: path.cateringPackageId
          blockId: path.blockId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/blocks/{blockId}/events/changesByDateTime'].get
  update:
    x-apievangelist-phrasing:
      intent: Find a block's events changed in a time window
      effect: read
      questions:
      - Which events on a block were created, updated or deleted since yesterday?
      - Can I sync event changes on a block within a three-day window?
      instructions:
      - text: List events on block {blockId} at hotel {hotelId} modified since {startLastModifiedDate}.
        slots:
          blockId: path.blockId
          hotelId: path.hotelId
          startLastModifiedDate: query.startLastModifiedDate
      - text: Get block {blockId} event changes from {startLastModifiedDate} to {endLastModifiedDate}, including inactive ones.
        slots:
          blockId: path.blockId
          startLastModifiedDate: query.startLastModifiedDate
          endLastModifiedDate: query.endLastModifiedDate
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/cateringEventChanges'].get
  update:
    x-apievangelist-phrasing:
      intent: Review the change log of catering events
      effect: read
      questions:
      - Who changed a catering event and what did they change?
      - What status changes happened on our events over the last 90 days?
      instructions:
      - text: Show the catering event change log for event {eventId} at hotel {hotelId}.
        slots:
          eventId: query.eventId
          hotelId: path.hotelId
      - text: List catering event changes for block {blockId} at hotel {hotelId}.
        slots:
          blockId: query.blockId
          hotelId: path.hotelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/eventcalendar'].get
  update:
    x-apievangelist-phrasing:
      intent: View one hotel's event calendar
      effect: read
      questions:
      - What does the function space calendar look like for a single property this week?
      - Can I filter a hotel's event calendar by setup style or space type?
      instructions:
      - text: Show the event calendar for hotel {hotelId} from {eventStartDate} to {eventEndDate}.
        slots:
          hotelId: path.hotelId
          eventStartDate: query.eventStartDate
          eventEndDate: query.eventEndDate
      - text: Show hotel {hotelId}'s calendar with hidden events and available rooms.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/events'].get
  update:
    x-apievangelist-phrasing:
      intent: Search catering events at one hotel
      effect: read
      questions:
      - Which catering events are booked at a single property for a given block?
      - Can I find a hotel's events by status or function space?
      instructions:
      - text: Find catering events at hotel {hotelId} for block {blockId}.
        slots:
          hotelId: path.hotelId
          blockId: query.blockId
      - text: Search hotel {hotelId} events between {eventStartDate} and {eventEndDate}.
        slots:
          hotelId: path.hotelId
          eventStartDate: query.eventStartDate
          eventEndDate: query.eventEndDate
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/events/{eventId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of one event
      effect: read
      questions:
      - What are the type, times and space of a specific catering event?
      - Can I pull up one event's full details by its event ID?
      instructions:
      - text: Get event {eventId} at hotel {hotelId}.
        slots:
          eventId: path.eventId
          hotelId: path.hotelId
      - text: Show me everything about event {eventId} at hotel {hotelId}.
        slots:
          eventId: path.eventId
          hotelId: path.hotelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/events/{eventId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an existing event
      effect: write
      questions:
      - How do I change the time or room of an event that is already booked?
      - Can I edit an existing catering event by its ID?
      instructions:
      - text: Update event {eventId} at hotel {hotelId} with {eventDetails}.
        slots:
          eventId: path.eventId
          hotelId: path.hotelId
          eventDetails: requestBody.eventDetails
      - text: Move event {eventId} at hotel {hotelId} to a later start time.
        slots:
          eventId: path.eventId
          hotelId: path.hotelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/events/{eventId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one event
      effect: destructive
      questions:
      - How do I delete a single catering event from a hotel?
      - Will deleting an event also remove its sub-events?
      instructions:
      - text: Delete event {eventId} at hotel {hotelId}.
        slots:
          eventId: path.eventId
          hotelId: path.hotelId
      - text: Delete event {eventId} and its sub-events at hotel {hotelId}.
        slots:
          eventId: path.eventId
          hotelId: path.hotelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/events/{eventId}/cateringEventPostings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the postings on a catering event
      effect: read
      questions:
      - What charges have been posted to a catering event?
      - Can I see an event's postings including its sub-events?
      instructions:
      - text: Show catering postings on event {eventId} at hotel {hotelId}.
        slots:
          eventId: path.eventId
          hotelId: path.hotelId
      - text: List postings for event {eventId} at hotel {hotelId} on block {blockId}.
        slots:
          eventId: path.eventId
          hotelId: path.hotelId
          blockId: query.blockId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/events/{eventId}/cateringEventPostings'].put
  update:
    x-apievangelist-phrasing:
      intent: Manage the postings on a catering event
      effect: write
      questions:
      - How do I post or adjust charges on a catering event?
      - Can I change which posting master reservation an event's charges go to?
      instructions:
      - text: Update postings on event {eventId} at hotel {hotelId} with {cateringEventPostings}.
        slots:
          eventId: path.eventId
          hotelId: path.hotelId
          cateringEventPostings: requestBody.cateringEventPostings
      - text: Route event {eventId} postings at hotel {hotelId} to posting master {postingMasterReservations}.
        slots:
          eventId: path.eventId
          hotelId: path.hotelId
          postingMasterReservations: requestBody.postingMasterReservations
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/events/{eventId}/eventResources/{quickInsertId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Quick-insert a configured resource on an event
      effect: write
      questions:
      - Can I add a preset menu to an event using its quick insert number?
      - How do I drop a configured miscellaneous item onto a catering event quickly?
      instructions:
      - text: Quick-insert resource {quickInsertId} on event {eventId} at hotel {hotelId}.
        slots:
          quickInsertId: path.quickInsertId
          eventId: path.eventId
          hotelId: path.hotelId
      - text: Add quick insert {quickInsertId} to event {eventId} with {quickInsertResourceListInfo}.
        slots:
          quickInsertId: path.quickInsertId
          eventId: path.eventId
          quickInsertResourceListInfo: requestBody.quickInsertResourceListInfo
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/events/{eventId}/menus/{menuId}/menuItems'].post
  update:
    x-apievangelist-phrasing:
      intent: Add menu items to a booked menu
      effect: write
      questions:
      - How do I add extra dishes to a menu already booked on an event?
      - Can I add several menu items to a booked menu by their item IDs?
      instructions:
      - text: Add menu items {menuItemIds} to menu {menuId} on event {eventId} at hotel {hotelId}.
        slots:
          menuItemIds: requestBody.menuItemIds
          menuId: path.menuId
          eventId: path.eventId
          hotelId: path.hotelId
      - text: Put items {menuItemIds} on the booked menu {menuId} for event {eventId}.
        slots:
          menuItemIds: requestBody.menuItemIds
          menuId: path.menuId
          eventId: path.eventId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/events/{eventId}/notes/copy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy event notes to other events
      effect: write
      questions:
      - Can I copy the notes from one event to other events in the same block?
      - How do I reuse setup notes across several events?
      instructions:
      - text: Copy notes from event {eventId} at hotel {hotelId} to events {targetEventWithHotelIds}.
        slots:
          eventId: path.eventId
          hotelId: path.hotelId
          targetEventWithHotelIds: requestBody.targetEventWithHotelIds
      - text: Copy notes {notes} from event {eventId} to the other events on block {blockId}.
        slots:
          notes: requestBody.notes
          eventId: path.eventId
          blockId: requestBody.blockId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/eventsResources'].get
  update:
    x-apievangelist-phrasing:
      intent: List resources booked on events
      effect: read
      questions:
      - Which items and menus are booked on the events for a block?
      - What resources are attached to a set of events at a property?
      instructions:
      - text: List event resources at hotel {hotelId} for block {blockId}.
        slots:
          hotelId: path.hotelId
          blockId: query.blockId
      - text: Show resources on events {eventIds} at hotel {hotelId}.
        slots:
          eventIds: query.eventIds
          hotelId: path.hotelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/eventsResources'].put
  update:
    x-apievangelist-phrasing:
      intent: Update event resources at a hotel
      effect: write
      questions:
      - How do I update the menus and items on events at one property?
      - Can I change booked event items for a specific hotel in one request?
      instructions:
      - text: Update event items at hotel {hotelId} to {eventItems}.
        slots:
          hotelId: path.hotelId
          eventItems: requestBody.eventItems
      - text: Change the booked menus on hotel {hotelId}'s events to {eventMenus}.
        slots:
          hotelId: path.hotelId
          eventMenus: requestBody.eventMenus
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/fetchBlockPostingAccountReservations'].get
  update:
    x-apievangelist-phrasing:
      intent: List a block's posting account reservations
      effect: read
      questions:
      - Which posting master reservations can a block's event charges go to?
      - What posting accounts exist for a block's catering charges?
      instructions:
      - text: List posting account reservations for block {blockId} at hotel {hotelId}.
        slots:
          blockId: query.blockId
          hotelId: path.hotelId
      - text: Show hotel {hotelId}'s block posting accounts.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/functionalSpace'].get
  update:
    x-apievangelist-phrasing:
      intent: Check function space availability
      effect: read
      questions:
      - Which meeting rooms are free for 80 attendees next Tuesday?
      - Can I search function space availability by setup style and area?
      instructions:
      - text: Find available function space at hotel {hotelId} from {eventStartDate} to {eventEndDate}.
        slots:
          hotelId: path.hotelId
          eventStartDate: query.eventStartDate
          eventEndDate: query.eventEndDate
      - text: Check function space at hotel {hotelId} for {attendeesFrom} to {attendeesTo} people.
        slots:
          hotelId: path.hotelId
          attendeesFrom: query.attendeesFrom
          attendeesTo: query.attendeesTo
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hotels/{hotelId}/functionalSpaceEvents'].get
  update:
    x-apievangelist-phrasing:
      intent: Find events sharing a function space
      effect: read
      questions:
      - Are two events double-booked in the same room at overlapping times?
      - Which events share a function space during a given window?
      instructions:
      - text: Show events sharing space {functionSpaceCode} at hotel {hotelId}.
        slots:
          functionSpaceCode: query.functionSpaceCode
          hotelId: path.hotelId
      - text: Check overlapping bookings in {functionSpaceCode} between {startDateTime} and {endDateTime} at hotel {hotelId}.
        slots:
          functionSpaceCode: query.functionSpaceCode
          startDateTime: query.startDateTime
          endDateTime: query.endDateTime
          hotelId: path.hotelId
      method: generated
      generated: '2026-10-01'


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