Oracle Hospitality Block API
These APIs will allow you to completely create and manage your block in OPERA Cloud - including all related functionalities of a block such as manage Room allocation, Status update, block reservations.You can search for a block, get a Block, update and create new Blocks.
Operations 90
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 carve a sub allocation out of a master allocation in OPERA Cloud?”
“Can I create several sub allocations in one request?”
Tell an agent
Create a sub allocation at hotel {hotel} from these details.
Add sub allocations {sub_allocations} to the master allocation.
Ask an LLM
“Who changed what on our group blocks, and when?”
“Can I filter the block activity log by activity type and date range?”
Tell an agent
Show the block activity log for hotel {hotel} from {from} to {to}.
List block activity of type {type} performed by user {user}.
Ask an LLM
“How do I release unsold group rooms from a block for a range of dates?”
“Can I wash allocation for only certain room types on a block?”
Tell an agent destructive · confirm first
Wash the block allocation described in {wash} to remove rooms for those dates and room types.
Remove unpicked block rooms at hotel {hotel} for the given dates and room types.
Ask an LLM
“What block information do I need before washing unused rooms from a group block?”
“Can I see wash details for a block's generic room type?”
Tell an agent
Get block wash information for block {block} at hotel {hotel}.
Show wash details for block {block} and generic room type {room_type}.
Ask an LLM
“How can I list all group blocks arriving in a given date range?”
“Can I filter blocks by status, owner or block code?”
Tell an agent
List blocks at hotel {hotel} with status {status}.
Find blocks named {name} starting on or after {start}.
Ask an LLM
“Does this block rate code overlap with other blocks before I save it?”
“How do I validate block details and create them in one step?”
Tell an agent
Validate the block rate code details {rate_details} for overlapping blocks.
Validate and create block details for {blocks}.
GET
/blocks/dailyStatistics
Get block daily statistics for a date range · Get Block Daily Statistics
#
Ask an LLM
“What do group block statistics look like day by day at my hotel?”
“Can I break down block daily statistics by generic room type?”
Tell an agent
Get block daily statistics for hotel {hotel} from {start} to {end}.
Show daily block stats for generic room type {room_type} at {hotel}.
Ask an LLM
“Can I send block search criteria as a POST body instead of query parameters?”
“How do I search blocks across multiple hotels with a long criteria list?”
Tell an agent
Search blocks via the POST search endpoint across hotels {hotels}.
Run a POST block search for block code {code} with status {status}.
Ask an LLM
“From tentative, which statuses can a block be moved to next?”
“Can I include catering statuses in the allowed status transitions?”
Tell an agent
Show the next allowed block statuses after {status} at hotel {hotel}.
List status transitions from {status}, including catering statuses.
PUT
/blocks/{blockCode}/actions/validate
Validate a block code before using it · Validate Block Code
#
Ask an LLM
“Is this block code unique and consistent with the block code template?”
“Does a block code need to start on the inventory week start day?”
Tell an agent
Validate block code {code} at hotel {hotel}.
Check block code {code} for dates {start} to {end}.
POST
/blocks/{blockId}/alternateDates
Add alternate dates to a block · Create alternate dates for a Block
#
Ask an LLM
“Can I record alternate arrival dates a group would accept?”
“How do I add new alternate dates to a block that has none yet?”
Tell an agent
Add alternate dates {dates} to block {block}.
Create new alternate dates for block {block} at hotel {hotel}.
PUT
/blocks/{blockId}/alternateDates
Change a block's alternate dates · Change alternate dates for a Block
#
Ask an LLM
“How do I update the alternate dates already recorded on a group block?”
“Can I edit the backup date options a group gave us?”
Tell an agent
Change the existing alternate dates on block {block} to {dates}.
Update block {block}'s alternate date options at hotel {hotel}.
DELETE
/blocks/{blockId}/alternateDates
Remove a block's alternate dates · Delete alternate dates for a Block
#
Ask an LLM
“How do I clear the alternate dates on a group block?”
“Can I remove all alternate date options once the group confirms?”
Tell an agent destructive · confirm first
Delete the alternate dates on block {block}.
Clear alternate date options from block {block}.
Ask an LLM
“What documents are attached to a group block?”
“Can I find a block attachment by its file name?”
Tell an agent
List the attachments on block {block}.
Find the attachment named {file} on block {block}.
DELETE
/blocks/{blockId}/attachments/{attachId}
Delete a file attached to a block · Delete Block Attachment
#
Ask an LLM
“How do I remove an old contract file attached to a block?”
“Can I delete a single attachment without touching the rest of the block?”
Tell an agent destructive · confirm first
Delete attachment {attachment} from block {block}.
Remove file {attachment} attached to block {block}.
PUT
/blocks/{blockId}/blockAccessExclusion
Set access exclusions on a block · Set Block Exclusion information
#
Ask an LLM
“Can I stop certain channels or sources from booking into a block?”
“How do I control whether a source can create, modify or cancel block reservations?”
Tell an agent
Set access exclusions {exclusions} on block {block}.
Exclude a booking source from block {block}'s availability.
DELETE
/blocks/{blockId}/blockAccessExclusion
Delete an access exclusion from a block · Delete Block access exclusion
#
Ask an LLM
“How do I lift a booking source exclusion from a block?”
“Can I remove the exclusion for one source type and value only?”
Tell an agent destructive · confirm first
Remove the access exclusion for source {source} on block {block}.
Delete block {block}'s exclusion of source type {source_type} at hotel {hotel}.
Ask an LLM
“How do I release a block's remaining rooms back to house as of today?”
“Can I force the cutoff on a group block before its cutoff date?”
Tell an agent destructive · confirm first
Cut off block {block} effective today.
Release block {block}'s allocation at hotel {hotel} as of the current date.
Ask an LLM
“Who are the sales owners assigned to a group block?”
“Which salespeople own this block at the property?”
Tell an agent
Show the owners of block {block}.
List block {block}'s owners at hotel {hotel}.
Ask an LLM
“Can I add another sales owner to a block?”
“How do I assign an owner to a block that has none?”
Tell an agent
Assign a new owner to block {block}.
Add owner {criteria} to block {block}.
Ask an LLM
“How do I take a salesperson off a block?”
“Can I delete a block owner assignment?”
Tell an agent destructive · confirm first
Delete the owner from block {block}.
Remove the owner assignment on block {block}.
Ask an LLM
“How do I reassign a block from one salesperson to another?”
“Can I replace the existing owners on a block?”
Tell an agent
Change the existing owners on block {block}.
Reassign block {block} using owner criteria {criteria}.
Ask an LLM
“After a rate code changed, how do I refresh the rates on a block?”
“Can I recalculate block rates without editing the room grid?”
Tell an agent
Refresh the rates on block {block}.
Refresh block {block} rates at hotel {hotel}.
Ask an LLM
“Can I make a change across the reservations already booked in a block?”
“How do I bulk-update group reservations on a block?”
Tell an agent
Apply changes {criteria} to the reservations in block {block}.
Update the booked reservations on block {block}.
GET
/blocks/{blockId}/reservations
List reservations booked in a block · Retrieves all reservations created for the Block
#
Ask an LLM
“Which guest reservations have been picked up in a group block?”
“How many reservations are already booked against this block?”
Tell an agent
List all reservations in block {block}.
Get block {block}'s reservations at hotel {hotel}.
Ask an LLM
“What booking restrictions are set on a group block for certain dates?”
“How far apart can the start and end dates be when reading block restrictions?”
Tell an agent
Show restrictions on block {block} from {start} to {end}.
List block {block} restrictions for room type {room_type}.
Ask an LLM
“Can I close a block to arrivals or set a minimum stay on certain dates?”
“How do I create a new booking restriction on a group block?”
Tell an agent
Create restriction {restriction} on block {block}.
Add a booking restriction to block {block}.
DELETE
/blocks/{blockId}/restrictions
Delete a specific restriction from a block · Delete Block Restriction
#
Ask an LLM
“How do I remove one restriction code from a block for a date range?”
“Can I delete a block restriction only for certain room types?”
Tell an agent destructive · confirm first
Delete restriction {code} on block {block} at hotel {hotel} from {start} to {end}.
Remove restriction {code} for room types {room_types} on block {block} at {hotel} between {start} and {end}.
PUT
/blocks/{blockId}/restrictions
Clear all restrictions on a block for a date · Clear-All Block Restrictions
#
Ask an LLM
“How do I wipe every restriction on a block for one day?”
“Can I clear all block restrictions at once instead of one code at a time?”
Tell an agent destructive · confirm first
Clear all restrictions on block {block} for {date}.
Remove every restriction from block {block} on {date} at hotel {hotel}.
GET
/blocks/{blockId}/revenueActivityLog
Get revenue changes logged for a block · Fetch Block Revenue Changes
#
Ask an LLM
“How has the revenue on a group block changed over the last month?”
“Are the block revenue change records deltas or totals?”
Tell an agent
Show revenue changes for block {block} between {start} and {end}.
List block {block} revenue log entries with status {status}.
PUT
/blocks/{blockId}/roomTypeOrder
Set the room type display order for a block · Set room type order for a Block
#
Ask an LLM
“Can I change the order room types appear in on a block's grid?”
“How do I put suites at the top of a block's room type list?”
Tell an agent
Set block {block}'s room type order to {room_types}.
Reorder the room types shown on block {block}.
Ask an LLM
“Which room types are available on a particular group block?”
“Can I get only the room types that already have allocation on a block?”
Tell an agent
List room types for block {block} from {start} to {end}.
Show only allocated room types on block {block}.
POST
/blocks/{blockId}/roomingList
Create reservations from a block rooming list · Create Block Rooming List Reservations
#
Ask an LLM
“How do I load a group's rooming list into reservations on the block?”
“Can shared rooms be created as part of a rooming list upload?”
Tell an agent
Create rooming list reservations {reservations} on block {block}.
Import the rooming list for block {block} with shares {shares}.
GET
/blocks/{blockId}/roomsStatus
Get room status for a block's rooms · Get room status for a Block
#
Ask an LLM
“Are the rooms assigned to a group block clean and ready?”
“What housekeeping status do a block's rooms have?”
Tell an agent
Show room status for block {block}.
Get the room readiness of block {block} at hotel {hotel}.
Ask an LLM
“How is a single group block performing on pickup and revenue?”
“Can I narrow block statistics to one room type or booking channel?”
Tell an agent
Get statistics for block {block} starting {start} for {days} days.
Show block {block} statistics for room type {room_type}.
GET
/blocks/{blockId}/statusActivityLog
Get a block's status change history · Get Block Status Activity Log
#
Ask an LLM
“When did a block move from tentative to definite?”
“Can I see status changes on a block within a date range?”
Tell an agent
Show the status change log for block {block}.
List block {block} status changes between {start} and {end}.
Ask an LLM
“How do I generate a recurring tour series based on an existing block?”
“Can I set up weekly tour blocks from one template block?”
Tell an agent
Create a tour series from block {block}.
Build a tour series for block {block} using {criteria}.
PUT
/blocks/{blockId}/tourSeries/validate
Validate a tour series before creating it · Validate Block tour series
#
Ask an LLM
“Will my tour series settings work before I actually create the series?”
“Can I dry-run a tour series for a block?”
Tell an agent
Validate the tour series criteria {criteria} for block {block}.
Check the proposed tour series on block {block} without creating it.
Ask an LLM
“When is the group block scheduled to release unsold rooms?”
“What wash dates and percentages are set up on a block?”
Tell an agent
Show the wash schedule for block {block}.
Get block {block}'s wash schedule at hotel {hotel}.
POST
/blocks/{blockId}/washSchedules
Create wash schedules for a block · Create Block Wash Schedules
#
Ask an LLM
“How do I schedule automatic release of a block's unsold rooms?”
“Can I set a new wash schedule by percentage per room type?”
Tell an agent
Create wash schedules {schedules} on block {block}.
Add a new wash schedule to block {block}.
Ask an LLM
“Can I change the wash date or wash percentage on an existing schedule?”
“How do I adjust the sell limit in a block's wash schedule?”
Tell an agent
Update the existing wash schedules on block {block} to {schedules}.
Change block {block}'s current wash dates and percentages.
DELETE
/blocks/{blockId}/washSchedules
Remove all wash schedules from a block · Remove Block Wash Schedules
#
Ask an LLM
“How do I remove all the wash schedules from a block by block ID alone?”
“Can I delete a block's wash schedules without passing a hotel in the path?”
Tell an agent destructive · confirm first
Delete the wash schedules on block {block}.
Remove every wash schedule from block {block} using the block-only endpoint.
Ask an LLM
“Can I duplicate last year's group block for this year's event?”
“How do I create a new block using an existing one as a template?”
Tell an agent
Copy block {source} into a new block.
Create a new block from template block {source} with {criteria}.
PUT
/caterings/{eventId}/cateringStatus
Change the catering status of an event · Change Catering Status
#
Ask an LLM
“How do I move a catering event to a new status?”
“Can I just verify a catering status change without applying it?”
Tell an agent
Change the catering status of event {event}.
Verify the catering status change {change} for event {event} without saving.
Ask an LLM
“Which properties can a central sales lead be sent to in a given country?”
“Can I find central sales hotels by marketing city or amenity?”
Tell an agent
List central sales hotels in country {country}.
Find central sales hotels in {city} that offer amenity {amenity}.
Ask an LLM
“How do I reset a block to the property's contract defaults?”
“Can contract default settings be applied to an existing block?”
Tell an agent
Set contract defaults on block {block} at hotel {hotel}.
Apply the default contract settings to block {block}.
Ask an LLM
“What block code would the template assign to a new group?”
“Can I preview a default block code from a block name and start date?”
Tell an agent
Get the default block code for {name} starting {start}.
Suggest a block code using template {template} at hotel {hotel}.
POST
/defaultBlockCode
Create default block codes for multiple blocks · Create default Block Code for Multiple blocks
#
Ask an LLM
“Can I generate template-based block codes for many blocks at once?”
“How are default block codes created in bulk from the Block Code Template setting?”
Tell an agent
Create default block codes for blocks {blocks}.
Generate template block codes for several blocks at hotel {hotel}.
Ask an LLM
“How do I create a new group block in OPERA Cloud?”
“What do I need to look up before creating a block, like status or market codes?”
Tell an agent
Create a new block at hotel {hotel}.
Create block {blocks} at hotel {hotel}.
GET
/hotels/{hotelId}/blockDailyRevenue
Get block revenue for a date · Get Block Revenue for a given date
#
Ask an LLM
“What revenue did group blocks bring in on a particular day?”
“Can I filter daily block revenue by owner or block status?”
Tell an agent
Get block revenue at hotel {hotel} for {date}.
Show {date} block revenue at {hotel} for owner {owner}.
GET
/hotels/{hotelId}/blocks/changesByDateTime
Find blocks created, changed or deleted recently · Get modified blocks from a specific time period in OPERA
#
Ask an LLM
“Which blocks were created, updated or deleted since my last sync?”
“What is the longest time window I can query for block changes?”
Tell an agent
List blocks modified at hotel {hotel} since {since}.
Get block changes at {hotel} between {since} and {until}, including event changes.
Ask an LLM
“How do I pull the full details of one block when I know its OPERA block ID?”
“Can I include the room grid for a date range when fetching a single block?”
Tell an agent
Get block {block} at hotel {hotel}.
Fetch OPERA block {block} at {hotel} with its grid from {start} for {days} days.
PUT
/hotels/{hotelId}/blocks/{blockId}
Update a block's header details by OPERA ID · Change a Block
#
Ask an LLM
“How do I change a block's description or market segment using its OPERA ID?”
“Can I update block header information on an existing group?”
Tell an agent
Update the header of OPERA block {block} at hotel {hotel}.
Change block {block} at {hotel} with {blocks}.
Ask an LLM
“How do I delete a group block that was entered by mistake?”
“Can a block be deleted if it still has reservations attached?”
Tell an agent destructive · confirm first
Delete block {block} at hotel {hotel}.
Permanently remove block {block} from {hotel}.
PUT
/hotels/{hotelId}/blocks/{blockId}/allocation
Set room allocations and rates on a block · Set Block Allocation
#
Ask an LLM
“How do I load room counts and rates into a block using its OPERA ID?”
“Can I add room type allocation to a block's grid?”
Tell an agent
Set room type allocations and rates on OPERA block {block} at hotel {hotel}.
Add allocation {criteria} to block {block} at {hotel}.
PUT
/hotels/{hotelId}/blocks/{blockId}/allocationRange
Set block allocation across a date range · Set Block Allocation Range
#
Ask an LLM
“Can I set the same room count on a block for a whole date range at once?”
“How do I update allocation for several room types over many nights by OPERA block ID?”
Tell an agent
Set allocation range {range} on OPERA block {block} at hotel {hotel}.
Apply a date-range room allocation to block {block} at {hotel}.
GET
/hotels/{hotelId}/blocks/{blockId}/allocationRange
Get block data for a date-range allocation update · Get Block Range Information
#
Ask an LLM
“What block information do I need before updating allocation across a date range?”
“Can I get range allocation info for one generic room type?”
Tell an agent
Get allocation range information for block {block} at hotel {hotel}.
Show range details for block {block} at {hotel}, generic room type {room_type}.
GET
/hotels/{hotelId}/blocks/{blockId}/availability
Check room and rate availability in a block · Get Block AvailaBility
#
Ask an LLM
“Are there rooms left in a group block for a guest arriving on a certain date?”
“What rates can I book within a block for two adults over three nights?”
Tell an agent
Check availability in block {block} at hotel {hotel} for arrival {arrival} for {nights} nights.
Find block {block} availability at {hotel} for {adults} adults in room type {room_type}.
Ask an LLM
“How do I cancel a group block when the event falls through?”
“Can I record a cancellation reason when cancelling a block?”
Tell an agent destructive · confirm first
Cancel block {block} at hotel {hotel}.
Cancel block {block} at {hotel} with details {cancel}.
PUT
/hotels/{hotelId}/blocks/{blockId}/cateringRevenue
Recalculate catering revenue for a block · Recalculate Catering Revenue
#
Ask an LLM
“How do I recalculate the catering revenue on a business block?”
“Can I refresh expected and guaranteed catering revenue for one event?”
Tell an agent
Recalculate catering revenue on block {block} at hotel {hotel}.
Recalculate catering revenue for event {event} on block {block} at {hotel}.
GET
/hotels/{hotelId}/blocks/{blockId}/exchangeInterfaces
List external systems receiving a block's events · Get exchange interfaces from business block
#
Ask an LLM
“Which external systems is a block sending business events to?”
“Can I see the exchange interfaces configured on a business block?”
Tell an agent
Show the exchange interfaces for block {block} at hotel {hotel}.
List external systems receiving events from block {block} at {hotel}.
PUT
/hotels/{hotelId}/blocks/{blockId}/exchangeInterfaces
Set which external systems a block sends events to · Set exchange interfaces for business block
#
Ask an LLM
“How do I start sending a block's business events to another external system?”
“Can I change the exchange interfaces on a business block?”
Tell an agent
Set exchange interfaces {systems} for block {block} at hotel {hotel}.
Configure block {block} at {hotel} to send events to {systems}.
PUT
/hotels/{hotelId}/blocks/{blockId}/openStatus
Open a block for reservation pickup · Change Block status to Open
#
Ask an LLM
“How do I make a block ready to accept reservations?”
“Can I move a block straight to Open for Pickup?”
Tell an agent
Open block {block} at hotel {hotel} for pickup.
Set block {block} at {hotel} to Open for Pickup so guests can book.
POST
/hotels/{hotelId}/blocks/{blockId}/postingMaster
Create a posting master reservation for a block · Create Block posting master
#
Ask an LLM
“How do I create a posting master to collect group charges on a block?”
“Does the block have to be open for pickup before adding a posting master?”
Tell an agent
Create a posting master reservation on OPERA block {block} at hotel {hotel}.
Add a posting master to block {block} at {hotel} using {criteria}.
GET
/hotels/{hotelId}/blocks/{blockId}/postingMaster/reservations
List posting master reservations by OPERA block ID · Get Posting Master Reservations for a Block
#
Ask an LLM
“Which posting master reservations exist on a block when I have its OPERA ID?”
“Where are group charges being posted for this block?”
Tell an agent
List posting master reservations for OPERA block {block} at hotel {hotel}.
Show the PM reservations on block ID {block} at {hotel}.
PUT
/hotels/{hotelId}/blocks/{blockId}/rate/override
Allow or block rate overrides on a block · Change rate override
#
Ask an LLM
“Can I let agents override the block rate on group reservations?”
“How do I record a reason when enabling rate override on a block?”
Tell an agent
Set rate override to {allow} on block {block} at hotel {hotel}.
Change block {block} at {hotel} rate override with reason {reason}.
PUT
/hotels/{hotelId}/blocks/{blockId}/regularToMasterBlock/{masterBlockCode}
Convert a regular block into a master block · Use this API to convert a regular block to a master block
#
Ask an LLM
“How do I turn a regular block into a master block with sub blocks?”
“What happens to the room grid when a regular block becomes a master?”
Tell an agent
Convert block {block} at hotel {hotel} to master block {master_code}.
Make regular block {block} at {hotel} a sub block under new master {master_code}.
PUT
/hotels/{hotelId}/blocks/{blockId}/regularToSubAllocation/{masterAllocationId}
Convert a regular block to a sub allocation · Convert a regular business block to a sub allocation under a master allocation…
#
Ask an LLM
“Can I attach an existing regular block to a master allocation as a sub allocation?”
“Does the master allocation need to be in the same property?”
Tell an agent
Convert block {block} at hotel {hotel} into a sub allocation of master allocation {master}.
Link regular block {block} at {hotel} under master allocation {master}.
PUT
/hotels/{hotelId}/blocks/{blockId}/regularToSubTour/tourHotels/{masterTourHotelId}/tours/{masterTourId}
Convert a regular block to a sub tour or itinerary · Convert a regular block to a sub tour or sub itinerary under a master tour or…
#
Ask an LLM
“How do I link a regular block to a master tour as a sub tour?”
“Can a sub itinerary be in a different property than its master itinerary?”
Tell an agent
Convert block {block} at hotel {hotel} to a sub tour of master tour {tour} at hotel {tour_hotel}.
Attach regular block {block} at {hotel} to master itinerary {tour} held at {tour_hotel}.
GET
/hotels/{hotelId}/blocks/{blockId}/roomRateGrid
Get a block's room and rate grid · Operation to get room rate grid for a Block and supports pagination
#
Ask an LLM
“How do I see the nightly rooms and rates grid for a block?”
“Can the block room rate grid be paged for long events?”
Tell an agent
Get the room rate grid for block {block} at hotel {hotel}.
Show block {block}'s grid at {hotel} from {start} for {days} days.
Ask an LLM
“The group moved their event by a week; how do I shift the whole block?”
“Can I move a block's start date and keep its grid?”
Tell an agent
Shift block {block} at hotel {hotel} to new dates.
Move the dates of block {block} at {hotel} using {criteria}.
PUT
/hotels/{hotelId}/blocks/{blockId}/status
Change a block's status by OPERA ID · Change the Status of a Block
#
Ask an LLM
“How do I move a block from inquiry to definite using its OPERA block ID?”
“Why can't I move a block back from definite to inquiry?”
Tell an agent
Change the status of OPERA block {block} at hotel {hotel} to {status}.
Verify whether block ID {block} at {hotel} can change status, without applying it.
PUT
/hotels/{hotelId}/blocks/{blockId}/subBlockToRegular
Convert a sub block back to a regular block · Use this API to convert a sub block to a regular block
#
Ask an LLM
“How do I detach a sub block from its master and make it regular?”
“What happens to the master block if its only sub block becomes regular?”
Tell an agent
Convert sub block {block} at hotel {hotel} to a regular block.
Detach sub block {block} at {hotel} from its master.
POST
/hotels/{hotelId}/blocks/{blockId}/subBlocks
Create a sub block under an OPERA block ID · Create a sub-Block
#
Ask an LLM
“How do I add a sub block under a master block I know by OPERA ID?”
“Can I split a group into sub blocks under one master?”
Tell an agent
Create a sub block under OPERA block {block} at hotel {hotel}.
Add sub block {criteria} beneath block ID {block} at {hotel}.
DELETE
/hotels/{hotelId}/blocks/{blockId}/washSchedules
Remove a block's wash schedule for a wash date · Remove Block Wash Schedule
#
Ask an LLM
“Can I delete the wash schedule for just one wash date on a block?”
“How do I remove a block wash schedule at a specific hotel?”
Tell an agent destructive · confirm first
Delete the wash schedule for {wash_date} on block {block} at hotel {hotel}.
Remove block {block}'s wash schedule at {hotel}.
GET
/hotels/{hotelId}/externalSystems/{externalSystemCode}/blocks/{blockExternalId}
Get a block by an external system's ID · Get a Block By ID
#
Ask an LLM
“Can I look up a block using the ID my sales system assigned instead of the OPERA ID?”
“How do I fetch a block by its external reference?”
Tell an agent
Get block {ext_id} from external system {system} at hotel {hotel}.
Fetch the block known as {ext_id} in {system} at {hotel}, including instructions {fetch}.
PUT
/hotels/{hotelId}/externalSystems/{externalSystemCode}/blocks/{blockExternalId}
Update a block using an external system's ID · Change a Block
#
Ask an LLM
“How do I update a block when I only have my external system's block ID?”
“Can an external sales system push block header changes by its own reference?”
Tell an agent
Update block {ext_id} from external system {system} at hotel {hotel}.
Change external block {ext_id} in {system} at {hotel} with {blocks}.
PUT
/hotels/{hotelId}/externalSystems/{externalSystemCode}/blocks/{blockExternalId}/allocation/roomTypes/{roomType}
Set one room type's allocation by external block ID · Set Block Allocation
#
Ask an LLM
“Can my external system set the allocation for a single room type on its block?”
“How do I load rooms and rates for one room type using an external block reference?”
Tell an agent
Set room type {room_type} allocation on external block {ext_id} from {system} at hotel {hotel}.
Load rates and rooms for {room_type} on {system} block {ext_id} at {hotel}.
PUT
/hotels/{hotelId}/externalSystems/{externalSystemCode}/blocks/{blockExternalId}/allocationRange
Set block allocation over dates by external ID · Set Block Allocation Range
#
Ask an LLM
“Can my external system set a date-range allocation on a block by its own ID?”
“How do I update several room types across nights for an externally referenced block?”
Tell an agent
Set a date-range allocation on external block {ext_id} from {system} at hotel {hotel}.
Apply allocation range {range} to {system} block {ext_id} at {hotel}.
GET
/hotels/{hotelId}/externalSystems/{externalSystemCode}/blocks/{blockExternalId}/postingMaster/reservations
List posting master reservations by external block ID · Get Posting Master Reservations for a Block
#
Ask an LLM
“Can I get a block's posting master reservations using my external system's block ID?”
“Where are charges posted for a block I track externally?”
Tell an agent
List posting master reservations for external block {ext_id} from {system} at hotel {hotel}.
Show PM reservations on {system} block {ext_id} at {hotel}.
PUT
/hotels/{hotelId}/externalSystems/{externalSystemCode}/blocks/{blockExternalId}/status
Change a block's status by external ID · Change the Status of a Block
#
Ask an LLM
“How does my external sales system move a block to definite using its own block ID?”
“Can I verify a status change for an externally referenced block before applying it?”
Tell an agent
Change the status of external block {ext_id} from {system} at hotel {hotel} to {status}.
Verify a status change for {system} block {ext_id} at {hotel} without applying it.
POST
/hotels/{hotelId}/externalSystems/{externalSystemCode}/blocks/{blockExternalId}/subBlocks
Create a sub block under an external block ID · Create a sub-Block
#
Ask an LLM
“Can I create a sub block under a master that I know only by its external ID?”
“How does an external system add sub blocks to its own master block?”
Tell an agent
Create a sub block under external block {ext_id} from {system} at hotel {hotel}.
Add sub block {criteria} beneath {system} block {ext_id} at {hotel}.
POST
/hotels/{hotelId}/leads/{leadId}/propertyLeads
Create property leads from a central lead · Use this API to create Property Leads
#
Ask an LLM
“How do I send a central sales lead out to specific properties?”
“Can one central lead create property leads for several hotels?”
Tell an agent
Create property leads for hotels {hotels} from central lead {lead}.
Distribute lead {lead} at hotel {hotel} to other properties.
GET
/hotels/{hotelId}/tracesByDateRange
Get reservation and block traces for dates · Get Traces By Date Range
#
Ask an LLM
“Which follow-up traces are due for reservations and blocks this week?”
“Can I filter traces by department?”
Tell an agent
Get traces at hotel {hotel} from {begin} to {end}.
List {department} traces at {hotel} for the coming days.
Ask an LLM
“The block is out of a room type; can I borrow rooms from the house or another type?”
“How do I borrow inventory so a block reservation can be made?”
Tell an agent
Borrow inventory for block {block} room type {room_type}.
Borrow rooms {borrow} into block {block} for reservation {reservation}.
Ask an LLM
“How do I give back rooms a block borrowed from house inventory?”
“Can borrowed rooms be returned to the original room type?”
Tell an agent
Return borrowed inventory on block {block} for room type {room_type}.
Give back {returns} borrowed by block {block} to its original source.
Ask an LLM
“Where can I borrow rooms from when a block runs short on a room type?”
“How many rooms are available to borrow for a block on certain dates?”
Tell an agent
Find borrowable inventory for {rooms} rooms in block {block} at hotel {hotel} from {start}.
Show what room type {room_type} inventory block {block} at {hotel} can borrow for {rooms} rooms starting {start}.
Ask an LLM
“Which blocks did I open most recently?”
“Can I get a quick list of recently viewed group blocks?”
Tell an agent
Show my recently accessed blocks at hotel {hotel}.
List the blocks I viewed recently.
Ask an LLM
“What is the maximum number of rooms that can be sold under a sales allowance?”
“Can I see the sales allowance for a specific ceiling?”
Tell an agent
Get the sales allowance for ceiling {ceiling}.
Show the sales allowances at hotel {hotel}.
GET
/services/block/status
Check the Block service version and status · This API retrieves the Block service version
#
Ask an LLM
“Is the OPERA Cloud Block service up?”
“What version of the Block service is deployed?”
Tell an agent
Ping the Block service for hotel {hotel}.
Get the Block service version.
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