Oracle Hospitality Event Management API
The Event APIs will allow you to retrieve, create, manage and delete events and related event functionality such as event resources, catering packages and even event waitlists.
Operations 45
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“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?”
Tell an agent
Apply these alternate event changes: {alternateEvents}.
Run the alternate-event instruction {instruction} on the listed events.
POST
/blocks/{blockId}/cateringPackages
Add a catering package to a block · Add catering packages to a block
#
Ask an LLM
“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?”
Tell an agent
Add a catering package to block {blockId} using {criteria}.
Book a new catering package onto block {blockId}.
Ask an LLM
“Which catering packages are already booked on this group block?”
“What catering packages does a block currently carry in OPERA Cloud?”
Tell an agent
Show the catering packages on block {blockId}.
List catering packages for block {blockId} at hotel {hotelId}.
PUT
/blocks/{blockId}/cateringPackages
Update catering packages already on a block · Update a Catering packages
#
Ask an LLM
“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?”
Tell an agent
Update the existing catering packages on block {blockId} with {cateringPackageList}.
Edit the catering packages already booked on block {blockId}.
PUT
/blocks/{blockId}/cateringPackages/{cateringpackageId}/copy
Copy a catering package to another date · Copy a Catering package
#
Ask an LLM
“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?”
Tell an agent
Copy catering package {cateringpackageId} on block {blockId} to another date.
Duplicate package {cateringpackageId} on block {blockId} using {criteria}.
GET
/blocks/{blockId}/cateringPackages/{cateringpackageId}/revenue
Get revenue for a catering package · Get Catering package revenue
#
Ask an LLM
“How much revenue is a specific catering package on a block bringing in?”
“What revenue lines are recorded against one catering package?”
Tell an agent
Show revenue for catering package {cateringpackageId} on block {blockId}.
Get the catering package {cateringpackageId} revenue breakdown for hotel {hotelId}.
POST
/blocks/{blockId}/cateringPackages/{cateringpackageId}/revenue
Add revenue to a catering package · Add catering package revenue to a block
#
Ask an LLM
“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?”
Tell an agent
Add revenue {cateringPackageRevenueDetails} to package {cateringpackageId} on block {blockId}.
Record new revenue for catering package {cateringpackageId} on block {blockId}.
PUT
/blocks/{blockId}/events/{eventId}/resources/copy
Copy event resources to other events · Copy event resources
#
Ask an LLM
“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?”
Tell an agent
Copy the resources from event {eventId} on block {blockId} to other events.
Copy resources of event {eventId} on block {blockId} using {criteria}.
PUT
/blocks/{blockId}/events/{eventId}/resources/move
Move event resources to another event · Move event resources
#
Ask an LLM
“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?”
Tell an agent
Move resources from event {eventId} on block {blockId} to another event.
Transfer event {eventId} resources on block {blockId} using {criteria}.
GET
/blocks/{blockId}/events/{eventId}/resources/{resourceId}
Get one resource on an event · Get Resources for an Event
#
Ask an LLM
“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?”
Tell an agent
Get resource {resourceId} on event {eventId} of block {blockId}.
Show the menu resource {resourceId} booked on event {eventId} for block {blockId}.
Ask an LLM
“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?”
Tell an agent
Bulk update these catering events on the block: {cateringEventsBulkUpdate}.
Apply the same change to all the catering events I list for this block.
Ask an LLM
“How do I correct revenue already recorded on a catering package?”
“Can I adjust existing catering package revenue on a block?”
Tell an agent
Update the catering package revenue to {cateringPackageRevenueDetails}.
Change the recorded revenue on this block's catering package.
Ask an LLM
“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?”
Tell an agent destructive · confirm first
Delete revenue type {cateringPackageRevenueType} from catering package event {cateringPackageEventId}.
Remove the catering package revenue for event {cateringPackageEventId} at hotel {hotelId}.
Ask an LLM
“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?”
Tell an agent
Update this event resource with {eventResourceDetails}.
Change the quantity on a single booked event resource.
GET
/eventcalendar
View the event calendar across hotels · Get the event calendar for Multiple Properties
#
Ask an LLM
“Can I see one event calendar covering several of our properties at once?”
“Which function spaces are booked across multiple hotels next week?”
Tell an agent
Show the event calendar for hotels {hotelIds} from {eventStartDate} to {eventEndDate}.
Show the multi-property event calendar for hotels {hotelIds}, including opportunities.
Ask an LLM
“Which catering events are booked across all our hotels in a date range?”
“Can I find events by name or status across several properties?”
Tell an agent
Find catering events at hotels {hotelIds} between {eventStartDate} and {eventEndDate}.
Search events named {name} across hotels {hotelIds}.
Ask an LLM
“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?”
Tell an agent
Create a catering event with {eventDetails}.
Book a new reception event for the group.
Ask an LLM
“Can I delete a whole list of catering events in one call?”
“How do I remove multiple events and their sub-events together?”
Tell an agent destructive · confirm first
Delete events {eventIds}.
Delete events {eventIds} at hotels {hotelIds} including their sub-events.
GET
/events/{eventId}/splitQuantity
Get an event item's split quantity · Get Event item split quantity
#
Ask an LLM
“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?”
Tell an agent
Show the item split quantity for event {eventId}.
Get split quantity of item {itemId} on event {eventId} for {eventStartDate}.
Ask an LLM
“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?”
Tell an agent
Update event menus {eventMenus} through the chain-level resources endpoint.
Change chain-wide event items to {eventItems}.
GET
/hotels/{hotelId}/block/{blockId}/resourceEvents
List a block's events that use a resource · Get events for the block ID and resource ID(optional)
#
Ask an LLM
“Which events on a block have a particular resource booked?”
“Can I list a block's events and filter them to one resource?”
Tell an agent
List events on block {blockId} at hotel {hotelId}.
Find events on block {blockId} at hotel {hotelId} that use resource {resourceId}.
PUT
/hotels/{hotelId}/blocks/{blockId}/cateringEvents/copy
Copy a catering event to new dates · Copy Catering Event
#
Ask an LLM
“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?”
Tell an agent
Copy the catering event on block {blockId} at hotel {hotelId} to new dates.
Copy catering events on block {blockId} at hotel {hotelId} using {criteria}.
DELETE
/hotels/{hotelId}/blocks/{blockId}/cateringPackages
Remove several catering packages from a block · Delete one or more catering package(s)
#
Ask an LLM
“Can I remove several catering packages from a block in one go?”
“How do I delete a list of packages from a group booking?”
Tell an agent destructive · confirm first
Remove catering packages {cateringPackageId} from block {blockId} at hotel {hotelId}.
Delete the listed catering packages {cateringPackageId} from block {blockId}.
DELETE
/hotels/{hotelId}/blocks/{blockId}/cateringPackages/{cateringPackageId}
Remove one catering package from a block · Delete Catering package
#
Ask an LLM
“How do I delete a single catering package from a block by its ID?”
“What happens if I take one package off a block?”
Tell an agent destructive · confirm first
Delete catering package {cateringPackageId} from block {blockId} at hotel {hotelId}.
Take package {cateringPackageId} off block {blockId}.
GET
/hotels/{hotelId}/blocks/{blockId}/events/changesByDateTime
Find a block's events changed in a time window · Get modified events from a specific time period in OPERA
#
Ask an LLM
“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?”
Tell an agent
List events on block {blockId} at hotel {hotelId} modified since {startLastModifiedDate}.
Get block {blockId} event changes from {startLastModifiedDate} to {endLastModifiedDate}, including inactive ones.
GET
/hotels/{hotelId}/cateringEventChanges
Review the change log of catering events · Get Catering Event changes
#
Ask an LLM
“Who changed a catering event and what did they change?”
“What status changes happened on our events over the last 90 days?”
Tell an agent
Show the catering event change log for event {eventId} at hotel {hotelId}.
List catering event changes for block {blockId} at hotel {hotelId}.
Ask an LLM
“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?”
Tell an agent
Show the event calendar for hotel {hotelId} from {eventStartDate} to {eventEndDate}.
Show hotel {hotelId}'s calendar with hidden events and available rooms.
Ask an LLM
“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?”
Tell an agent
Find catering events at hotel {hotelId} for block {blockId}.
Search hotel {hotelId} events between {eventStartDate} and {eventEndDate}.
Ask an LLM
“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?”
Tell an agent
Get event {eventId} at hotel {hotelId}.
Show me everything about event {eventId} at hotel {hotelId}.
Ask an LLM
“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?”
Tell an agent
Update event {eventId} at hotel {hotelId} with {eventDetails}.
Move event {eventId} at hotel {hotelId} to a later start time.
Ask an LLM
“How do I delete a single catering event from a hotel?”
“Will deleting an event also remove its sub-events?”
Tell an agent destructive · confirm first
Delete event {eventId} at hotel {hotelId}.
Delete event {eventId} and its sub-events at hotel {hotelId}.
GET
/hotels/{hotelId}/events/{eventId}/cateringEventPostings
Get the postings on a catering event · Get Catering Event postings
#
Ask an LLM
“What charges have been posted to a catering event?”
“Can I see an event's postings including its sub-events?”
Tell an agent
Show catering postings on event {eventId} at hotel {hotelId}.
List postings for event {eventId} at hotel {hotelId} on block {blockId}.
PUT
/hotels/{hotelId}/events/{eventId}/cateringEventPostings
Manage the postings on a catering event · Manage Catering Event postings
#
Ask an LLM
“How do I post or adjust charges on a catering event?”
“Can I change which posting master reservation an event's charges go to?”
Tell an agent
Update postings on event {eventId} at hotel {hotelId} with {cateringEventPostings}.
Route event {eventId} postings at hotel {hotelId} to posting master {postingMasterReservations}.
POST
/hotels/{hotelId}/events/{eventId}/eventResources/{quickInsertId}
Quick-insert a configured resource on an event · Add Resource to an Event in a hotel by ID
#
Ask an LLM
“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?”
Tell an agent
Quick-insert resource {quickInsertId} on event {eventId} at hotel {hotelId}.
Add quick insert {quickInsertId} to event {eventId} with {quickInsertResourceListInfo}.
POST
/hotels/{hotelId}/events/{eventId}/menus/{menuId}/menuItems
Add menu items to a booked menu · Add Menu Items to a Booked Menu
#
Ask an LLM
“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?”
Tell an agent
Add menu items {menuItemIds} to menu {menuId} on event {eventId} at hotel {hotelId}.
Put items {menuItemIds} on the booked menu {menuId} for event {eventId}.
PUT
/hotels/{hotelId}/events/{eventId}/notes/copy
Copy event notes to other events · Copy event notes
#
Ask an LLM
“Can I copy the notes from one event to other events in the same block?”
“How do I reuse setup notes across several events?”
Tell an agent
Copy notes from event {eventId} at hotel {hotelId} to events {targetEventWithHotelIds}.
Copy notes {notes} from event {eventId} to the other events on block {blockId}.
Ask an LLM
“Which items and menus are booked on the events for a block?”
“What resources are attached to a set of events at a property?”
Tell an agent
List event resources at hotel {hotelId} for block {blockId}.
Show resources on events {eventIds} at hotel {hotelId}.
Ask an LLM
“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?”
Tell an agent
Update event items at hotel {hotelId} to {eventItems}.
Change the booked menus on hotel {hotelId}'s events to {eventMenus}.
GET
/hotels/{hotelId}/fetchBlockPostingAccountReservations
List a block's posting account reservations · Get Catering Event postings
#
Ask an LLM
“Which posting master reservations can a block's event charges go to?”
“What posting accounts exist for a block's catering charges?”
Tell an agent
List posting account reservations for block {blockId} at hotel {hotelId}.
Show hotel {hotelId}'s block posting accounts.
GET
/hotels/{hotelId}/functionalSpace
Check function space availability · Get hotel's function space availability
#
Ask an LLM
“Which meeting rooms are free for 80 attendees next Tuesday?”
“Can I search function space availability by setup style and area?”
Tell an agent
Find available function space at hotel {hotelId} from {eventStartDate} to {eventEndDate}.
Check function space at hotel {hotelId} for {attendeesFrom} to {attendeesTo} people.
GET
/hotels/{hotelId}/functionalSpaceEvents
Find events sharing a function space · Get shared function space events
#
Ask an LLM
“Are two events double-booked in the same room at overlapping times?”
“Which events share a function space during a given window?”
Tell an agent
Show events sharing space {functionSpaceCode} at hotel {hotelId}.
Check overlapping bookings in {functionSpaceCode} between {startDateTime} and {endDateTime} at hotel {hotelId}.
Ask an LLM
“Which events are on the waitlist for a function room?”
“Can I see waitlisted events for a particular account or block?”
Tell an agent
List waitlisted events at hotel {hotelId}.
Show waitlisted events for account {accountName} at hotel {hotelId}.
Ask an LLM
“How do I change the priority order of events on a waitlist?”
“Can I update waitlisted events for a function space?”
Tell an agent
Reorder the waitlisted events at hotel {hotelId} as {waitlistedEvents}.
Move a waitlisted event to top priority at hotel {hotelId}.
POST
/opportunityEvents
Create events for an opportunity block · Create Events for Opportunity Block
#
Ask an LLM
“Can I add events to a sales opportunity before it becomes a real block?”
“How do I create catering events on an opportunity block?”
Tell an agent
Create events {opportunityEventDetails} for opportunity block {opportunityBlockInfo}.
Add a dinner event to the opportunity block {opportunityBlockInfo}.
GET
/services/eventManagement/status
Check the event management service status · This API facilitates status check of event management service
#
Ask an LLM
“Is the event management service up right now?”
“How can I health-check the catering events service?”
Tell an agent
Ping the event management service for hotel {hotel}.
Check whether the catering event service is responding.
Documentation
📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_oracle_hospitality_distribution_apis.htm
📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_oracle_hospitality_nor1_integrated_upsell_apis.htm
📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_property_apis.htm