Operations 179
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 log a phone call a guest made about their reservation?”
“Can the reservation system keep a record of reservation calls handled by agents?”
Tell an agent
Register this reservation call with details {call}.
Log the guest's inbound call against their booking.
Ask an LLM
“What call statistics can I pull for my reservation agents?”
“Is there a limit on the date range for call statistics?”
Tell an agent
Show call statistics from {start} to {end}.
Get call statistics for app user {user} over the last 30 days.
GET
/externalSystems/{extSystemCode}/reservations
Look up reservations by external system references · Get Reservations for a hotel
#
Ask an LLM
“Can I find hotel reservations using the reference numbers from my external system?”
“Which reservations match a list of external references from our channel system?”
Tell an agent
List reservations from external system {system} with external references {refs}.
Look up external system {system} bookings for references {refs} arriving from {from}.
POST
/externalSystems/{extSystemCode}/reservations/searches
Search external-system reservations via request body · Get Reservations for a hotel from an external system
#
Ask an LLM
“Can I post a search body to find reservations tied to an external system's references?”
“What search criteria can I send in the body when searching external system reservations?”
Tell an agent
Run a body-based reservation search for external system {system} with references {refs}.
Submit a search request for external system {system} references {refs} for guest surname {surname}.
GET
/hotels/{hotelId}/awardUpgrades
Get award upgrades available at a property · Get Award Upgrades
#
Ask an LLM
“Which loyalty award upgrades can a member redeem at this hotel?”
“Can I check award upgrades for a membership card number?”
Tell an agent
Show award upgrades at hotel {hotelId} for membership card {card}.
Get award upgrades at hotel {hotelId} for room type {roomType}.
Ask an LLM
“What certificates and awards are attached to a guest's reservation?”
“Can I see which award certificates a booking is using?”
Tell an agent
Fetch awards and certificates for reservation {reservationId} at hotel {hotelId}.
List award certificates tied to bookings at hotel {hotelId}.
POST
/hotels/{hotelId}/blocks/{blockId}/reservations
Create a reservation inside a group block · Create Reservation for a Block
#
Ask an LLM
“How do I book a room against a group block?”
“Can I pick up a room from a block's allotment for a wedding guest?”
Tell an agent
Create a reservation in block {blockId} at hotel {hotelId}.
Book {reservations} into group block {blockId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/cancellationPolicies
Change a property's cancellation policy · Change a Cancellation policy
#
Ask an LLM
“Can I edit a cancellation policy that's already configured for my hotel?”
“What do I send to change the property cancellation policy?”
Tell an agent
Update the cancellation policy at hotel {hotelId} to {policy}.
Change the existing cancellation policy configured for hotel {hotelId}.
GET
/hotels/{hotelId}/confirmationLetters
List reservations needing confirmation letters · Fetch Confirmation Letters
#
Ask an LLM
“Which reservations still need a confirmation letter sent?”
“Can I filter pending confirmation letters by arrival date?”
Tell an agent
List pending confirmation letters at hotel {hotelId}.
Show reservations at hotel {hotelId} arriving from {from} to {to} that need confirmation letters.
POST
/hotels/{hotelId}/confirmationLetters
Create confirmation letters for reservations · Create the confirmation letters
#
Ask an LLM
“How do I generate a confirmation letter for a guest's booking?”
“Can I create confirmation letters for a specific reservation?”
Tell an agent
Create a confirmation letter for reservation {reservationId} at hotel {hotelId}.
Generate confirmation letters {letters} at hotel {hotelId}.
Ask an LLM
“Can I modify the deposit policy my hotel already has?”
“What's needed to change an existing property deposit rule?”
Tell an agent
Update the deposit policy at hotel {hotelId} to {policy}.
Change the existing deposit policy configured for hotel {hotelId}.
POST
/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/linkedReservations/{reservationExternalId}
Link reservations using an external reservation ID · Link Reservations
#
Ask an LLM
“Can I link bookings together using the reservation ID from my external system?”
“How do I link reservations when I only have the external system's reference?”
Tell an agent
Link reservations {ids} to external reservation {extId} from system {system} at hotel {hotelId}.
Using external system {system} ID {extId}, link other bookings at hotel {hotelId}.
DELETE
/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/linkedReservations/{reservationExternalId}
Unlink a reservation by its external ID · Remove Reservation Links
#
Ask an LLM
“Can I unlink a reservation identified by my external system's ID?”
“What happens when I remove reservation links using an external reference?”
Tell an agent destructive · confirm first
Unlink external reservation {extId} from system {system} at hotel {hotelId}.
Remove the reservation links on external booking {extId} ({system}) at hotel {hotelId}.
GET
/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}
Get a reservation by its external system ID · Get Reservation by external ID
#
Ask an LLM
“How do I fetch a reservation using the ID from my booking engine?”
“Can I retrieve a booking when I only know the external reservation number?”
Tell an agent
Get reservation {extId} from external system {system} at hotel {hotelId}.
Show the booking with external ID {extId} ({system}) at hotel {hotelId}.
PUT
/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}
Update a reservation by its external system ID · Update Reservation by ID
#
Ask an LLM
“Can I change guest counts on a booking using the external reservation ID?”
“How do I update a reservation my channel system knows only by its own reference?”
Tell an agent
Update external reservation {extId} from {system} at hotel {hotelId} with {reservations}.
Add a comment to the booking with external ID {extId} ({system}) at hotel {hotelId}.
PUT
/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/addOnReservationPackagesByExtId
Update add-on packages via external reservation ID · Update Add On (Sell Separate) packages on a reservation
#
Ask an LLM
“Can I update sell-separate add-on packages on a booking known by its external ID?”
“Does the external-ID add-on package update replace the whole package list?”
Tell an agent
Set add-on packages {packages} on external reservation {extId} from {system} at hotel {hotelId}.
Update sell-separate packages on leg {leg} of external booking {extId} ({system}) at hotel {hotelId}.
PUT
/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/cancellations
Reinstate a cancelled reservation by external ID · Reinstate a Reservation
#
Ask an LLM
“Can I bring back a cancelled booking using the external system's reservation ID?”
“Is it possible to reinstate an externally referenced reservation and override inventory?”
Tell an agent
Reinstate cancelled external reservation {extId} from {system} at hotel {hotelId}.
Restore external booking {extId} ({system}) at hotel {hotelId}, overriding inventory {override}.
POST
/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/cancellations
Cancel a reservation by its external ID · Cancel Reservation by ID
#
Ask an LLM
“How do I cancel a guest's booking using my channel's reservation ID?”
“Do I get a cancellation number back when cancelling by external ID?”
Tell an agent destructive · confirm first
Cancel external reservation {extId} from {system} at hotel {hotelId}.
Cancel external booking {extId} ({system}) at hotel {hotelId} with reason {reason}.
POST
/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/routingInstructions
Create routing instructions via external reservation ID · Create routing instructions
#
Ask an LLM
“Can I add new charge routing to a booking using its external system ID?”
“How do I route a guest's charges to another folio when I only have the external reference?”
Tell an agent
Create routing instructions {criteria} on external reservation {extId} ({system}) at hotel {hotelId}.
Add new billing routing to external booking {extId} from {system} at hotel {hotelId}.
PUT
/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/routingInstructions
Change routing instructions via external reservation ID · Change routing instructions
#
Ask an LLM
“Can I edit billing routing on a reservation known by its external ID?”
“How do I modify existing routing instructions for an externally referenced booking?”
Tell an agent
Change routing instructions on external reservation {extId} ({system}) at hotel {hotelId} to {criteria}.
Update the existing charge routing for external booking {extId} from {system} at hotel {hotelId}.
PUT
/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/separatedShare
Separate a share by external ID with external daily rates · Separate Share Reservation with the given external reservation id and apply…
#
Ask an LLM
“Can I split a share reservation by external ID and apply daily rates from my external system?”
“When separating an external share, can I skip the max occupancy check?”
Tell an agent
Separate share external reservation {extId} ({system}) at hotel {hotelId} using external daily rates {criteria}.
Split external share {extId} from {system} at hotel {hotelId}, overriding the inventory check {override}.
GET
/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/shares
Get share reservations by external reservation ID · Get share Reservations
#
Ask an LLM
“Which share reservations exist on a booking my external system references?”
“Can I see who is sharing a room using the external reservation ID?”
Tell an agent
List share reservations on external reservation {extId} ({system}) at hotel {hotelId}.
Show sharers for external booking {extId} from {system} at hotel {hotelId}.
POST
/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/shares
Combine share reservations by external ID · Combine Share Reservations
#
Ask an LLM
“Can I combine two bookings into a share using the external reservation ID?”
“How do I make guests share a room when my system only has external references?”
Tell an agent
Combine share reservations {criteria} with external reservation {extId} ({system}) at hotel {hotelId}.
Share the room on external booking {extId} from {system} at hotel {hotelId} with another reservation.
DELETE
/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/shares
Separate share reservations by external ID · Separate share Reservations
#
Ask an LLM
“Can I break apart a share reservation using the external system's ID?”
“When separating shares by external ID, can I get the remaining shares back in the response?”
Tell an agent destructive · confirm first
Separate the share reservations on external reservation {extId} ({system}) at hotel {hotelId}.
Break the share on external booking {extId} from {system} at hotel {hotelId} and return shares {returnShares}.
GET
/hotels/{hotelId}/fetchExternalSystemDeliveryHistory
Get external system delivery history · Get External system delivery history
#
Ask an LLM
“Was a reservation successfully delivered to the external systems we interface with?”
“Can I see the delivery history of messages sent to external systems for a booking?”
Tell an agent
Show external system delivery history for reservation {reservationId} at hotel {hotelId}.
Get the external delivery log at hotel {hotelId}.
Ask an LLM
“Which guest messages at my hotel are still undelivered?”
“Can I find guest messages by room number or confirmation number?”
Tell an agent
List undelivered guest messages at hotel {hotelId}.
Find guest messages at hotel {hotelId} for room {room}.
Ask an LLM
“How do I release a reservation lock I'm holding so others can edit?”
“Can I give up a lock handle once my changes are saved?”
Tell an agent destructive · confirm first
Release reservation lock {lockHandle} at hotel {hotelId}.
Free up lock handle {lockHandle} so the booking at hotel {hotelId} is editable again.
Ask an LLM
“Can I keep my lock on a reservation longer while I finish editing?”
“How do I add time to a reservation lock before it expires?”
Tell an agent
Extend reservation lock {lockHandle} at hotel {hotelId} by {extra}.
Keep lock {lockHandle} at hotel {hotelId} alive longer.
GET
/hotels/{hotelId}/preArrivalMembersReservations
Get upcoming reservations for loyalty members · Get preArrival Member Reservations
#
Ask an LLM
“Which loyalty members are arriving at my hotel soon?”
“Can I list pre-arrival reservations by membership type?”
Tell an agent
List pre-arrival member reservations at hotel {hotelId} from {start} to {end}.
Show upcoming arrivals at hotel {hotelId} for membership type {type}.
GET
/hotels/{hotelId}/preConfiguredRoutingInstructions
Look up pre-configured routing instructions · Get pre-Configured Routing Instructions
#
Ask an LLM
“What default billing routing is set up for a company or rate code?”
“Can I see pre-configured routing for a travel agent profile?”
Tell an agent
Get pre-configured routing instructions at hotel {hotelId} for rate code {rateCode}.
Look up preset routing at hotel {hotelId} for company {company}.
POST
/hotels/{hotelId}/preConfiguredRoutingInstructions/searches
Search pre-configured routing via request body · Get pre-Configured Routing Instructions
#
Ask an LLM
“Can I post search criteria in the body to find preset routing instructions?”
“Is there a body-based search for pre-configured routing by group or guest?”
Tell an agent
Run a body search for pre-configured routing at hotel {hotelId} for group {group}.
Submit a routing preset search at hotel {hotelId} for guest {guest}.
GET
/hotels/{hotelId}/profiles/{profileIdtoShare}/share
Find reservations a guest profile can share · Get Reservations to share
#
Ask an LLM
“Which existing reservations could this guest profile join as a sharer?”
“Can I find shareable bookings for a profile by surname?”
Tell an agent
Find reservations profile {profileId} can share at hotel {hotelId}.
Show shareable bookings at hotel {hotelId} for profile {profileId} with surname {surname}.
PUT
/hotels/{hotelId}/rateInfoValidation
Validate rate plan information for a stay · Validate rate information
#
Ask an LLM
“Is the rate plan I picked valid for this reservation's dates?”
“Can I check rate information before committing a booking?”
Tell an agent
Validate rate information {criteria} at hotel {hotelId}.
Check that the chosen rate plan works for this booking at hotel {hotelId}.
Ask an LLM
“How do I list tonight's arrivals at a single hotel?”
“Can I look up a hotel's reservations by guest surname or confirmation number?”
Tell an agent
List reservations at hotel {hotelId} arriving between {from} and {to}.
Find the booking at hotel {hotelId} for guest surname {surname}.
Ask an LLM
“How do I book a new room reservation at a hotel?”
“What do I need to send to create a reservation after checking availability?”
Tell an agent
Create a reservation at hotel {hotelId} for {reservations}.
Book a new stay at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/activityLog
Fetch a reservation activity log · Fetch Reservation Activity Log
#
Ask an LLM
“Who changed this reservation and when?”
“Can I filter the reservation activity log by activity type and date?”
Tell an agent
Show the reservation activity log at hotel {hotelId} from {from} to {to}.
Get activity log entries at hotel {hotelId} of type {type}.
POST
/hotels/{hotelId}/reservations/alerts
Create or update alerts on many reservations · Create Bulk Reservation Alerts
#
Ask an LLM
“Can I add the same alert to many reservations at once?”
“Is there a bulk way to create reservation alerts for front desk staff?”
Tell an agent
Create bulk reservation alerts {reservations} at hotel {hotelId}.
Add a check-in alert to several bookings at hotel {hotelId} in one go.
POST
/hotels/{hotelId}/reservations/cancellations
Cancel multiple reservations at once · Cancel Reservations
#
Ask an LLM
“Can I cancel several reservations in a single request?”
“How do I bulk-cancel bookings at my hotel?”
Tell an agent destructive · confirm first
Cancel reservations {cancellations} at hotel {hotelId}.
Bulk cancel a batch of bookings at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/linkedReservations/{reservationId}
Link reservations to a reservation at a hotel · Link Reservations
#
Ask an LLM
“How do I link a family's separate room bookings together at one hotel?”
“Can I attach one or more reservations to an existing booking by its internal ID?”
Tell an agent
Link reservations {ids} to reservation {reservationId} at hotel {hotelId}.
Group other bookings under reservation {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/linkedReservations/{reservationId}
Unlink a reservation at a hotel · Remove Reservation Links
#
Ask an LLM
“How do I unlink a reservation from its linked group at my hotel?”
“Can I detach a booking from the reservation it's linked to by internal ID?”
Tell an agent destructive · confirm first
Unlink reservation {reservationId} at hotel {hotelId}.
Remove the link on booking {reservationId} at hotel {hotelId} from its associated reservation.
PUT
/hotels/{hotelId}/reservations/linkedReservations/{reservationId}
Update common details across linked reservations · Update Linked Reservations Common Details
#
Ask an LLM
“Can I change a detail once and apply it to every reservation linked to a booking?”
“What common details can I update across linked reservations?”
Tell an agent
Update common details {details} for all reservations linked to {reservationId} at hotel {hotelId}.
Apply shared changes across the linked group of reservation {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/packageCategoryReservations
Get reservations consuming a package on a date · Get Reservations by pacakge and consumption date
#
Ask an LLM
“Which guests have a breakfast package to consume on a given date?”
“Can I filter package consumption reservations by package category?”
Tell an agent
List reservations at hotel {hotelId} consuming packages on {date}.
Show bookings at hotel {hotelId} with package {package} on {date}.
PUT
/hotels/{hotelId}/reservations/policies
Find deposit and cancellation policies for criteria · Get Deposit and Cancellation Policies that are applicable to the specified…
#
Ask an LLM
“What deposit and cancellation rules would apply to a stay before I book it?”
“Can I estimate the deposit amount for given dates and rates?”
Tell an agent
Get applicable deposit and cancellation policies at hotel {hotelId} for arrival {arrival} to {departure}.
Check policies at hotel {hotelId} for guarantee code {guarantee} with an estimated amount.
GET
/hotels/{hotelId}/reservations/rateInfo
Get rate plan information for a stay · Get rate information
#
Ask an LLM
“What rates apply to a stay for two adults and a child?”
“Can I look up rate plan details by room type and dates?”
Tell an agent
Get rate information at hotel {hotelId} for rate plan {ratePlan} from {start} to {end}.
Show rate details at hotel {hotelId} for room type {roomType} with {adults} adults.
POST
/hotels/{hotelId}/reservations/rateInfo/searches
Search rate plan information via request body · Get rate information
#
Ask an LLM
“Can I post rate lookup criteria in a request body instead of query strings?”
“Is there a body-based rate information search for a block?”
Tell an agent
Run a body rate information search at hotel {hotelId} for rate plan {ratePlan}.
Submit a rate search at hotel {hotelId} for block {blockId} in currency {currency}.
POST
/hotels/{hotelId}/reservations/reservationCancellations
Cancel reservations including multiple sharers · Cancel reservations
#
Ask an LLM
“Can I cancel all the share reservations in a room with one request?”
“How do I cancel a shared booking and its sharers together?”
Tell an agent destructive · confirm first
Cancel share reservations {reservations} at hotel {hotelId} in one request.
Cancel every sharer on the room at hotel {hotelId} with reason {reason}.
POST
/hotels/{hotelId}/reservations/searches
Search one hotel's reservations via request body · Get Reservations for a hotel
#
Ask an LLM
“Can I send a POST search body to find reservations at a single hotel?”
“Is there a body-based search for a property's in-house guests?”
Tell an agent
Run a body search of hotel {hotelId} reservations for surname {surname}.
Submit a reservation search at hotel {hotelId} for arrivals from {from} to {to}.
GET
/hotels/{hotelId}/reservations/statistics
Get distribution reservation statistics · Get Reservation DistributionReservationsSummary
#
Ask an LLM
“How many reservations came through each distribution channel?”
“Can I get channel booking statistics for a date range?”
Tell an agent
Show distribution reservation statistics at hotel {hotelId} from {start} to {end}.
Get the distribution summary at hotel {hotelId} for channel {channel}.
GET
/hotels/{hotelId}/reservations/summary
Get a brief summary list of reservations · Get brief summary for Reservations
#
Ask an LLM
“Can I get a lightweight summary of reservations instead of full records?”
“Which pre-registered reservations arrive today, in summary form?”
Tell an agent
Get brief reservation summaries at hotel {hotelId} arriving on {arrival}.
Show a short summary for confirmation {confirmation} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/summary/searches
Search brief reservation summaries via request body · Search brief summary for Reservations
#
Ask an LLM
“Is there a POST search that returns only brief reservation summaries?”
“Can I send summary search criteria like last name in a request body?”
Tell an agent
Run a body summary search at hotel {hotelId} for last name {lastName}.
Submit a brief-summary search at hotel {hotelId} for departures on {departure}.
PUT
/hotels/{hotelId}/reservations/validations
Validate a reservation before creating or changing it · Validate Reservation Before Creating or Applying Changes
#
Ask an LLM
“Can I check whether a new or modified reservation would be accepted before saving it?”
“What gets validated before I apply reservation changes?”
Tell an agent
Validate reservation {reservation} at hotel {hotelId} before saving.
Dry-run check my pending booking changes at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationIdtoShare}/share
Find reservations that can share with a booking · Get Reservations to share by Reservation id
#
Ask an LLM
“Which reservations could share a room with this existing booking?”
“Can I narrow shareable reservations by confirmation number?”
Tell an agent
Find reservations that can share with reservation {reservationId} at hotel {hotelId}.
List share candidates for booking {reservationId} at hotel {hotelId} with surname {surname}.
GET
/hotels/{hotelId}/reservations/{reservationId}
Get a reservation by its internal ID · Get Reservation by ID
#
Ask an LLM
“How do I pull up the full details of a reservation by its OPERA ID?”
“Can I mark a reservation as recently accessed when I open it?”
Tell an agent
Get reservation {reservationId} at hotel {hotelId}.
Open booking {reservationId} at hotel {hotelId} and include {fetch}.
PUT
/hotels/{hotelId}/reservations/{reservationId}
Update a reservation by its internal ID · Update Reservation by ID
#
Ask an LLM
“How do I change the number of guests on an existing reservation?”
“Can I add comments to a booking after it's been made?”
Tell an agent
Update reservation {reservationId} at hotel {hotelId} with {reservations}.
Change the guest count on booking {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}
Delete an on-hold reservation at a hotel · Delete a Reservation by resort
#
Ask an LLM
“Can I delete an in-session reservation that's still on hold at a hotel?”
“Does deleting a reservation at a hotel work for confirmed bookings or only on-hold ones?”
Tell an agent destructive · confirm first
Delete on-hold reservation {reservationId} at hotel {hotelId}.
Discard the in-session booking {reservationId} held at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/addOnReservationPackages
Update add-on packages on a reservation · Update Add On (Sell Separate) packages on a reservation
#
Ask an LLM
“How do I update the sell-separate add-on packages on a reservation?”
“Can I override inventory item availability when changing add-on packages?”
Tell an agent
Set add-on packages {packages} on reservation {reservationId} at hotel {hotelId}.
Replace the sell-separate add-ons on booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/alerts
Fetch alert notices for a reservation · Fetch Alert Notices
#
Ask an LLM
“What alerts pop up for staff when handling this reservation?”
“Can I include global alerts and welcome offers in a reservation's alert notices?”
Tell an agent
Show alert notices for reservation {reservationId} at hotel {hotelId}.
Get check-in area alerts {area} for booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/attachments
Get attachments on a reservation · Get Reservation attachments
#
Ask an LLM
“What files are attached to a guest's reservation?”
“Can I retrieve the web registration card attached to a booking?”
Tell an agent
List attachments on reservation {reservationId} at hotel {hotelId}.
Get the attached file named {fileName} on booking {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/attachments/{attachmentId}
Delete an attachment from a reservation · Delete Reservation attachments
#
Ask an LLM
“How do I remove a file attached to a reservation?”
“Can I delete a single attachment from a booking by its ID?”
Tell an agent destructive · confirm first
Delete attachment {attachmentId} from reservation {reservationId} at hotel {hotelId}.
Remove attached file {attachmentId} on booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/breakshares/action/validate
Validate before breaking a share reservation · Validate before breaking a share Reservation
#
Ask an LLM
“Will breaking this share reservation run into any problems?”
“Can I pre-check a share separation before I do it?”
Tell an agent
Validate breaking the share on reservation {reservationId} at hotel {hotelId}.
Pre-check whether booking {reservationId} at hotel {hotelId} can leave its share.
GET
/hotels/{hotelId}/reservations/{reservationId}/calls
Get a reservation's call history · Get the Reservation Call History
#
Ask an LLM
“What calls have been logged against this reservation?”
“Can I see the phone call history for a guest's booking?”
Tell an agent
Show the call history for reservation {reservationId} at hotel {hotelId}.
List logged calls on booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/cancellationHistory
Get a reservation's cancellation history · Get cancellation history
#
Ask an LLM
“When was this reservation cancelled and what were the stay details?”
“Can I filter cancellation history by room type or rate plan?”
Tell an agent
Get cancellation history for reservation {reservationId} at hotel {hotelId}.
Show cancellation records on booking {reservationId} at hotel {hotelId} for rate plan {ratePlan}.
POST
/hotels/{hotelId}/reservations/{reservationId}/cancellationPolicies
Create a cancellation policy on a reservation · Create a Cancellation policy
#
Ask an LLM
“How do I add a cancellation policy to a specific reservation?”
“Can I set a custom cancellation rule for one booking?”
Tell an agent
Create cancellation policy {policy} on reservation {reservationId} at hotel {hotelId}.
Add a new cancellation rule to booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/cancellationPolicies
Compute cancellation policies for a reservation · Compute the cancellation policies
#
Ask an LLM
“What cancellation penalty would apply to this reservation right now?”
“Can I calculate the cancellation policies on an existing booking?”
Tell an agent
Compute cancellation policies for reservation {reservationId} at hotel {hotelId}.
Calculate the cancellation terms for booking {reservationId} at hotel {hotelId} using {criteria}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/cancellationPolicies
Delete a cancellation policy from a reservation · Delete a Cancellation policy
#
Ask an LLM
“How do I remove a cancellation policy from a reservation?”
“Which policy ID do I need to delete a cancellation rule?”
Tell an agent destructive · confirm first
Delete cancellation policy {policyId} from reservation {reservationId} at hotel {hotelId}.
Remove cancellation rule {policyId} on booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/cancellations
Reinstate a cancelled reservation · Reinstate a Reservation
#
Ask an LLM
“How do I reinstate a reservation a guest cancelled by mistake?”
“Can I restore a cancelled booking and override rates?”
Tell an agent
Reinstate cancelled reservation {reservationId} at hotel {hotelId}.
Restore booking {reservationId} at hotel {hotelId}, overriding rates {overrideRates}.
POST
/hotels/{hotelId}/reservations/{reservationId}/cancellations
Cancel a reservation · Cancel Reservation by ID
#
Ask an LLM
“How do I cancel a guest's reservation?”
“Will I receive a cancellation number when I cancel a booking?”
Tell an agent destructive · confirm first
Cancel reservation {reservationId} at hotel {hotelId}.
Guest wants out: cancel OPERA booking {reservationId} at hotel {hotelId}, logging reason {reason}.
POST
/hotels/{hotelId}/reservations/{reservationId}/certificates
Attach an award certificate to a reservation · Attach Certificate
#
Ask an LLM
“How do I apply a loyalty award certificate to a booking?”
“Can I attach a free-night certificate to a reservation?”
Tell an agent
Attach certificate {awards} to reservation {reservationId} at hotel {hotelId}.
Apply an award certificate to booking {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/certificates
Detach a certificate from a reservation · Detach Certificate
#
Ask an LLM
“How do I remove an award certificate from a reservation?”
“Can I take a certificate off a booking the guest no longer wants to use?”
Tell an agent destructive · confirm first
Detach the certificate from reservation {reservationId} at hotel {hotelId}.
Remove the award certificate on booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/combineshares/action/validate
Validate before combining share reservations · Combine Share Validations
#
Ask an LLM
“Can two reservations be combined into a share without errors?”
“Is there a pre-check before I combine bookings as sharers?”
Tell an agent
Validate combining reservation {reservationId} at hotel {hotelId} with {shareTo}.
Pre-check a share combine for booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/consumedPackageQuantity
Update consumed package quantities · Update consumed package quantity for package codes
#
Ask an LLM
“How do I record that a guest used two of their included breakfasts?”
“Can I update the consumed quantity for a package code on a reservation?”
Tell an agent
Update consumed package quantity {info} on reservation {reservationId} at hotel {hotelId}.
Mark package usage as consumed for booking {reservationId} at hotel {hotelId}.
Ask an LLM
“Can I duplicate an existing reservation for a returning guest?”
“How do I make a copy of a booking with the same details?”
Tell an agent
Copy reservation {reservationId} at hotel {hotelId}.
Duplicate booking {reservationId} at hotel {hotelId} using {criteria}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/dailyRates/action/validate
Validate a daily rate detail change · Validate daily rate details change
#
Ask an LLM
“Will changing a night's rate on this reservation be allowed?”
“Can I validate daily rate edits before applying them?”
Tell an agent
Validate the daily rate change {detail} on reservation {reservationId} at hotel {hotelId}.
Pre-check nightly rate edits for booking {reservationId} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/{reservationId}/depositPolicies
Create a deposit policy on a reservation · Create deposit policy
#
Ask an LLM
“How do I add a deposit requirement to a reservation?”
“Can I create a deposit policy for a specific booking?”
Tell an agent
Create deposit policy {policy} on reservation {reservationId} at hotel {hotelId}.
Add a deposit rule to booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/depositPolicies
Compute deposit policies for a reservation · Computes the deposit policies
#
Ask an LLM
“How much deposit is due on this reservation under its policies?”
“Can I calculate the deposit requirements for an existing booking?”
Tell an agent
Compute deposit policies for reservation {reservationId} at hotel {hotelId}.
Calculate deposit terms for booking {reservationId} at hotel {hotelId} using {criteria}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/depositPolicies
Delete a deposit policy from a reservation · Delete deposit policy
#
Ask an LLM
“How do I remove a deposit policy from a reservation?”
“What ID do I pass to delete a deposit rule?”
Tell an agent destructive · confirm first
Delete deposit policy {policyId} from reservation {reservationId} at hotel {hotelId}.
Remove deposit rule {policyId} on booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/eCoupons
Get e-coupons on a reservation · Get Reservation Ecoupons
#
Ask an LLM
“What e-coupons does this guest have on their reservation?”
“Can I page through a booking's electronic coupons?”
Tell an agent
List e-coupons on reservation {reservationId} at hotel {hotelId}.
Show electronic coupons for booking {reservationId} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/{reservationId}/eCoupons
Create e-coupons on a reservation · Create Reservation ECoupon
#
Ask an LLM
“How do I issue a new e-coupon to a guest's reservation?”
“Can I add electronic coupons to a booking?”
Tell an agent
Create e-coupons {coupons} on reservation {reservationId} at hotel {hotelId}.
Issue a new electronic coupon for booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/eCoupons
Change e-coupons on a reservation · Change Reservation Ecoupon
#
Ask an LLM
“How do I modify an existing e-coupon on a reservation?”
“Can I update the electronic coupons already issued to a booking?”
Tell an agent
Update e-coupons {coupons} on reservation {reservationId} at hotel {hotelId}.
Change the existing electronic coupons on booking {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/eCoupons
Delete e-coupons from a reservation · Delete Reservation ECoupons
#
Ask an LLM
“How do I remove an e-coupon from a reservation?”
“Can I delete one specific electronic coupon by ID?”
Tell an agent destructive · confirm first
Delete e-coupon {couponId} from reservation {reservationId} at hotel {hotelId}.
Remove the electronic coupons on booking {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/flexFieldCode/{flexFieldCode}
Delete a flex field value from a reservation · Operation to delete a flex field
#
Ask an LLM
“How do I clear a custom flex field value on a reservation?”
“Can I remove one flex field by its code from a booking?”
Tell an agent destructive · confirm first
Delete flex field {code} from reservation {reservationId} at hotel {hotelId}.
Clear the custom field value {code} on booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/flexFieldValues
Fetch flex field values on a reservation · Operation to fetch flex field values
#
Ask an LLM
“What custom flex field values are stored on this reservation?”
“Can I look up a reservation's flex field by code?”
Tell an agent
Get flex field values on reservation {reservationId} at hotel {hotelId}.
Show the value of flex field {code} on booking {reservationId} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/{reservationId}/flexFieldValues
Create a flex field value on a reservation · Operation to create a flex field with value for a module
#
Ask an LLM
“How do I add a new custom flex field to a reservation?”
“Can I store an extra value on a booking using a flex field?”
Tell an agent
Create flex field value {info} on reservation {reservationId} at hotel {hotelId}.
Add a new custom field to booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/flexFieldValues
Update a flex field value on a reservation · Operation to update flex field value
#
Ask an LLM
“How do I change a custom flex field value already on a reservation?”
“Can I edit an existing flex field on a booking?”
Tell an agent
Update flex field value {info} on reservation {reservationId} at hotel {hotelId}.
Change the existing custom field on booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/guestLocators
Fetch guest locators on a reservation · Fetch Reservation Guest Locator
#
Ask an LLM
“Where did the guest say they'd be if someone calls for them?”
“Can I see the guest locator notes on a reservation?”
Tell an agent
Get guest locators for reservation {reservationId} at hotel {hotelId}.
Show where the guest on booking {reservationId} at hotel {hotelId} can be found.
POST
/hotels/{hotelId}/reservations/{reservationId}/guestLocators
Create guest locators for reservations · Create Reservation Guest Locator
#
Ask an LLM
“How do I record that a guest is at the spa until 3pm?”
“Can I add a guest locator to several reservations at once?”
Tell an agent
Create guest locator {locators} on reservation {reservationId} at hotel {hotelId}.
Add a new whereabouts note for the guest on booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/guestLocators/{locatorId}
Change a guest locator on a reservation · Change Reservation Guest Locators
#
Ask an LLM
“Can I edit a guest locator entry that's already on a reservation?”
“How do I update where a guest said they'd be?”
Tell an agent
Change guest locator {locatorId} on reservation {reservationId} at hotel {hotelId} to {locators}.
Update locator {locatorId} for booking {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/guestLocators/{locatorId}
Remove a guest locator from a reservation · Remove Reservation Locators
#
Ask an LLM
“How do I delete an outdated guest locator?”
“Can I remove one locator entry from a booking?”
Tell an agent destructive · confirm first
Delete guest locator {locatorId} from reservation {reservationId} at hotel {hotelId}.
Remove locator {locatorId} on booking {reservationId} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/{reservationId}/guestMessages
Leave a guest message on a reservation · Create guest messages
#
Ask an LLM
“How do I leave a message for an in-house guest?”
“Can I post a new guest message to a reservation for the front desk to deliver?”
Tell an agent
Leave guest message {messages} on reservation {reservationId} at hotel {hotelId}.
Create a new message for the guest on booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/guestMessages
Change all guest messages on a reservation · Change Reservation Guest Messages
#
Ask an LLM
“Can I update the set of guest messages on a reservation in one call?”
“How do I mark a reservation's guest messages as delivered?”
Tell an agent
Update guest messages {messages} on reservation {reservationId} at hotel {hotelId}.
Change the message list for booking {reservationId} at hotel {hotelId} in bulk.
PUT
/hotels/{hotelId}/reservations/{reservationId}/guestMessages/{guestMessageId}
Change one guest message on a reservation · Change guest Message
#
Ask an LLM
“Can I edit the text of a single guest message I already left?”
“How do I update one specific guest message by its ID?”
Tell an agent
Change guest message {messageId} on reservation {reservationId} at hotel {hotelId}.
Edit message {messageId} for booking {reservationId} at hotel {hotelId} to {messages}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/guestMessages/{guestMessageId}
Delete a guest message from a reservation · Delete guest messages
#
Ask an LLM
“How do I delete a guest message that's no longer relevant?”
“Can I remove a single message from a guest's reservation?”
Tell an agent destructive · confirm first
Delete guest message {messageId} from reservation {reservationId} at hotel {hotelId}.
Remove message {messageId} left for booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/header/action/validate
Validate a reservation header change · Validate Reservation header change
#
Ask an LLM
“Will changing the stay dates or header details on this reservation pass validation?”
“Can I validate reservation header edits before saving them?”
Tell an agent
Validate header change {detail} on reservation {reservationId} at hotel {hotelId}.
Pre-check the header edits for booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/inventoryItems
Get inventory items reserved for a booking · Get Reserved Inventory Items
#
Ask an LLM
“Which rollaway beds or cribs are reserved for this stay?”
“Can I see the inventory items held for a reservation?”
Tell an agent
List reserved inventory items for reservation {reservationId} at hotel {hotelId}.
Show items held for booking {reservationId} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/{reservationId}/inventoryItems
Reserve inventory items for a booking · Reserve Reservation inventory items
#
Ask an LLM
“How do I reserve a crib or rollaway bed for a guest's stay?”
“Can I hold extra inventory items against a reservation?”
Tell an agent
Reserve inventory items {items} for reservation {reservationId} at hotel {hotelId}.
Hold a rollaway bed for booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/inventoryItems
Change inventory items reserved for a booking · Change reserved Inventory Items
#
Ask an LLM
“Can I change the quantity of an item already reserved for a guest?”
“How do I modify inventory items held on a reservation?”
Tell an agent
Update reserved inventory items {items} on reservation {reservationId} at hotel {hotelId}.
Change the held items on booking {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/inventoryItems
Release inventory items reserved for a booking · Delete Reserved Inventory Items
#
Ask an LLM
“How do I release items that were reserved for a guest who no longer needs them?”
“Can I delete all inventory items held on a reservation?”
Tell an agent destructive · confirm first
Delete reserved inventory items on reservation {reservationId} at hotel {hotelId}.
Release the held items for booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/linked
Get reservations linked to a reservation · Get linked Reservations
#
Ask an LLM
“Which other reservations are linked to this booking?”
“Can I see the full linked reservations for a family's rooms?”
Tell an agent
Get linked reservations for reservation {reservationId} at hotel {hotelId}.
Show bookings linked to {reservationId} at hotel {hotelId} with details {fetch}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/linked
Update a linked reservation · Update Linked Reservation by ID
#
Ask an LLM
“Can I change the link details between two linked reservations?”
“How do I set a back-to-back reservation on a linked booking?”
Tell an agent
Update linked reservation info {info} for reservation {reservationId} at hotel {hotelId}.
Make booking {reservationId} at hotel {hotelId} back-to-back with {backToBack}.
GET
/hotels/{hotelId}/reservations/{reservationId}/linkedSummary
Get a summary of linked reservations · Get Reservation summary for linked Reservation
#
Ask an LLM
“Can I get a quick summary of every reservation linked to a booking?”
“Is there a way to exclude cancelled or no-show bookings from the linked summary?”
Tell an agent
Summarize linked reservations for reservation {reservationId} at hotel {hotelId}.
Show only back-to-back linked bookings in summary for {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/locks
Acquire a lock on a reservation · Acquire Reservation Lock
#
Ask an LLM
“How do I lock a reservation so nobody else edits it while I work?”
“Can I take over a reservation lock I already hold?”
Tell an agent
Acquire a lock on reservation {reservationId} at hotel {hotelId}.
Lock booking {reservationId} at hotel {hotelId} for editing.
POST
/hotels/{hotelId}/reservations/{reservationId}/locks/break
Break someone's lock on a reservation · Break Reservation lock
#
Ask an LLM
“A reservation is stuck locked by another user, can I force the lock open?”
“How do I break an existing reservation lock?”
Tell an agent
Break the lock on reservation {reservationId} at hotel {hotelId}.
Force-release lock {lockHandle} held on booking {reservationId} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/{reservationId}/masterAccount
Create a master account for a reservation · Create a Master Account
#
Ask an LLM
“How do I set up a master account to collect charges for a reservation?”
“Can I create a master billing account on a booking?”
Tell an agent
Create master account {account} for reservation {reservationId} at hotel {hotelId}.
Open a new master account on booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/masterAccount
Change a reservation's master account · Change a Master Account
#
Ask an LLM
“Can I edit the master account attached to a reservation?”
“How do I change master billing details on a booking?”
Tell an agent
Update master account {account} on reservation {reservationId} at hotel {hotelId}.
Change the master account for booking {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/masterAccount
Cancel a reservation's master account · Cancel Master Account
#
Ask an LLM
“How do I cancel the master account on a reservation?”
“Can I remove master billing from a booking?”
Tell an agent destructive · confirm first
Cancel the master account on reservation {reservationId} at hotel {hotelId}.
Close out master billing for booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/mergeReservations
Merge multiple reservations into one · Merge multiple Reservations
#
Ask an LLM
“Can I merge duplicate reservations for the same guest?”
“How do I combine several bookings into a single reservation?”
Tell an agent
Merge reservations {toIds} with reservation {reservationId} at hotel {hotelId}.
Merge duplicate bookings from {fromId} at hotel {hotelId} starting with {reservationId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/move
Move a reservation to a different hotel · Move the Reservation
#
Ask an LLM
“How do I walk a guest by moving their reservation to a sister property?”
“Can I transfer a booking from one hotel to another?”
Tell an agent
Move reservation {reservationId} from hotel {hotelId} using {criteria}.
Transfer booking {reservationId} at hotel {hotelId} to another property.
GET
/hotels/{hotelId}/reservations/{reservationId}/packages
Check package availability for a reservation · Get Package
#
Ask an LLM
“Is a particular package available for this guest's stay?”
“Can I check package availability by product code and dates?”
Tell an agent
Check availability of package {product} for reservation {reservationId} at hotel {hotelId}.
See if package {product} can be added to booking {reservationId} at hotel {hotelId} for {qty} units.
POST
/hotels/{hotelId}/reservations/{reservationId}/packages
Add a package to a reservation · Add a package to a Reservation
#
Ask an LLM
“How do I add a breakfast or parking package to a guest's booking?”
“Can I attach new packages to an existing reservation?”
Tell an agent
Add packages {packages} to reservation {reservationId} at hotel {hotelId}.
Attach a new package to booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/packages
Update a package already on a reservation · Update a package on a Reservation
#
Ask an LLM
“How do I change the dates or quantity of a package already on a booking?”
“Can I edit existing packages on a reservation?”
Tell an agent
Update packages {packages} on reservation {reservationId} at hotel {hotelId}.
Edit the existing package on booking {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/packages
Remove a package from a reservation · Delete a package from a Reservation
#
Ask an LLM
“How do I take a package off a guest's reservation?”
“Can I delete packages from a booking?”
Tell an agent destructive · confirm first
Delete packages from reservation {reservationId} at hotel {hotelId}.
Remove the package attached to booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/payeeSharer
Mark a share reservation as the payee · Update Payee Sharer Information by ID
#
Ask an LLM
“Which sharer pays for the room, and can I change that?”
“How do I mark one shared reservation as the payee for the group?”
Tell an agent
Set reservation {reservationId} at hotel {hotelId} as payee sharer with {share}.
Unmark booking {reservationId} at hotel {hotelId} as the paying sharer.
POST
/hotels/{hotelId}/reservations/{reservationId}/paymentMethods
Add a payment method to a reservation · Create a payment method
#
Ask an LLM
“How do I add a credit card to a guest's reservation?”
“Can I attach a second payment method to a booking?”
Tell an agent
Add payment method {methods} to reservation {reservationId} at hotel {hotelId}.
Attach a new payment method to booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/paymentMethods
Get payment methods on a reservation · Get a payment method
#
Ask an LLM
“What payment methods are on file for this reservation?”
“Can I see the amounts attached to each payment method on a booking?”
Tell an agent
List payment methods on reservation {reservationId} at hotel {hotelId}.
Show payment methods with amounts {amounts} for booking {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/paymentMethods
Delete a payment method from a reservation · Delete a payment method
#
Ask an LLM
“How do I remove a card from a guest's reservation?”
“Can I delete a payment method on a booking?”
Tell an agent destructive · confirm first
Delete the payment method from reservation {reservationId} at hotel {hotelId}.
Remove the card on file for booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/paymentMethods
Change a payment method on a reservation · Change a payment method
#
Ask an LLM
“How do I update the card on file for a reservation?”
“Can I change an existing payment method on a booking?”
Tell an agent
Update payment methods {methods} on reservation {reservationId} at hotel {hotelId}.
Change the payment method already on booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/policies
Get deposit and cancellation policies on a reservation · Get Reservation Policies
#
Ask an LLM
“What deposit and cancellation policies are attached to this booking?”
“Can I fetch only the cancellation policies on a reservation?”
Tell an agent
Get the policies on reservation {reservationId} at hotel {hotelId}.
Show only cancellation policies {cancel} for booking {reservationId} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/{reservationId}/preCheckIn
Pre-check-in a reservation · Pre-Checkin a Reservation
#
Ask an LLM
“How do I pre-register a guest before they arrive?”
“Can a guest pre-check-in and view their folio on mobile?”
Tell an agent
Pre-check-in reservation {reservationId} at hotel {hotelId}.
Mark booking {reservationId} at hotel {hotelId} as pre-registered with {reservation}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/preCheckIn
Revert a pre-check-in with DELETE · Revert a PreCheckIn Reservation
#
Ask an LLM
“How do I undo a guest's pre-check-in using the DELETE method?”
“Can I revert pre-registration and pass the room number as a query parameter?”
Tell an agent destructive · confirm first
Revert the pre-check-in on reservation {reservationId} at hotel {hotelId} via DELETE.
Undo pre-registration for booking {reservationId} at hotel {hotelId} in room {room} with a DELETE call.
POST
/hotels/{hotelId}/reservations/{reservationId}/preCheckIn/deletions
Revert a pre-check-in with a POST body · Revert a PreCheckIn Reservation
#
Ask an LLM
“Is there a POST alternative for reverting a pre-check-in with details in the body?”
“Can I send the room and payment details in a body when undoing a pre-check-in?”
Tell an agent destructive · confirm first
Post a pre-check-in reversal for reservation {reservationId} at hotel {hotelId}.
Submit a deletion request body to undo pre-registration on booking {reservationId} at hotel {hotelId} for room {room}.
GET
/hotels/{hotelId}/reservations/{reservationId}/preferences
Get guest preferences on a reservation · Get Reservation Preferences
#
Ask an LLM
“What room preferences did the guest request on this booking?”
“Can I filter reservation preferences by preference type?”
Tell an agent
Get preferences on reservation {reservationId} at hotel {hotelId}.
Show {type} preferences for booking {reservationId} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/{reservationId}/preferences
Add a preference to a reservation · Add a preference to a Reservation
#
Ask an LLM
“How do I note that a guest wants a high floor?”
“Can I add a room preference to an existing booking?”
Tell an agent
Add preferences {prefs} to reservation {reservationId} at hotel {hotelId}.
Record a feather-free pillow preference on booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/preferences/{preferenceCode}
Change a preference on a reservation · Change a Reservation Preference
#
Ask an LLM
“Can I change one of a guest's existing reservation preferences?”
“How do I update a preference code on a booking?”
Tell an agent
Change preference {code} on reservation {reservationId} at hotel {hotelId}.
Update preference {code} on booking {reservationId} at hotel {hotelId} to {prefs}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/preferences/{preferenceCode}
Remove a preference from a reservation · Delete a Reservation Preference
#
Ask an LLM
“How do I delete a preference a guest no longer wants?”
“Can I remove a specific preference code from a booking?”
Tell an agent destructive · confirm first
Delete preference {code} from reservation {reservationId} at hotel {hotelId}.
Remove the {code} preference on booking {reservationId} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/{reservationId}/reverseDepositPolicy/{policyId}
Reverse a deposit policy on a reservation · Reverse a deposit policy
#
Ask an LLM
“Can I reverse a deposit policy that was applied to a reservation?”
“How do I undo a deposit requirement on a booking?”
Tell an agent destructive · confirm first
Reverse deposit policy {policyId} on reservation {reservationId} at hotel {hotelId}.
Undo deposit rule {policyId} applied to booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/routingInstructions
Get a reservation's routing instructions · Get routing instructions
#
Ask an LLM
“Where are this guest's charges being routed?”
“Can I include comp routing requests when fetching routing instructions?”
Tell an agent
Get routing instructions for reservation {reservationId} at hotel {hotelId}.
Show charge routing on booking {reservationId} at hotel {hotelId} effective {date}.
POST
/hotels/{hotelId}/reservations/{reservationId}/routingInstructions
Create routing instructions on a reservation · Create routing instructions for a reservation
#
Ask an LLM
“How do I route room charges to a company's folio?”
“Can I set up new routing instructions on a booking by its internal ID?”
Tell an agent
Set up routing {criteria} so charges on OPERA reservation {reservationId} at hotel {hotelId} go elsewhere.
Route room and tax charges for booking {reservationId} at hotel {hotelId} to a separate window.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/routingInstructions
Delete routing instructions from a reservation · Delete routing instructions
#
Ask an LLM
“How do I stop routing charges on a reservation?”
“Can I delete all routing instructions from a booking?”
Tell an agent destructive · confirm first
Delete routing instructions on reservation {reservationId} at hotel {hotelId}.
Remove charge routing from booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/routingInstructions
Change routing instructions on a reservation · Change routing instructions
#
Ask an LLM
“How do I modify where a reservation's charges are routed?”
“Can I edit existing routing on a booking by its internal ID?”
Tell an agent
Replace the routing on OPERA reservation {reservationId} at hotel {hotelId} with {criteria}.
Edit the existing charge routing for booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/scheduledRoomMoves/{scheduledMoveDate}
Update a scheduled room move · Update Scheduled Room Move Details based on reservationID and move date
#
Ask an LLM
“Can I change the time of a room move already scheduled for a guest?”
“How do I add comments to a scheduled room move?”
Tell an agent
Update the room move on {moveDate} for reservation {reservationId} at hotel {hotelId} to time {time}.
Add comment {comments} to the {moveDate} room move for booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/separatedShare
Separate a share and apply external daily rates · Separate Share Reservation and apply rate amounts to separated and remaining…
#
Ask an LLM
“Can I split a share reservation and apply daily room rates supplied by my external app?”
“When separating a share with external rates, can I override the rate availability check?”
Tell an agent
Separate share reservation {reservationId} at hotel {hotelId} applying external daily rates {criteria}.
Split share {reservationId} at hotel {hotelId} with rates from our system, overriding rate availability {override}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/shareRateAmount
Change share rate amounts · Change Share Rate Amount
#
Ask an LLM
“How do I split the room rate differently between sharers?”
“Can I change the share amounts on a shared reservation?”
Tell an agent
Change the share rate amounts on reservation {reservationId} at hotel {hotelId} to {criteria}.
Rebalance what each sharer pays on booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/sharedGuestCount
Change guest counts on a sharing reservation · Change Sharing Guests
#
Ask an LLM
“Can I change the number of adults or children on a sharing reservation?”
“How do I update guest counts for sharers in a room?”
Tell an agent
Change sharing guest counts on reservation {reservationId} at hotel {hotelId} to {reservations}.
Add a child to the sharers on booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/shares
Get share reservations on a reservation · Get share Reservations
#
Ask an LLM
“Who is sharing the room on this reservation?”
“Can I list the sharers on a booking by its internal ID?”
Tell an agent
Who shares OPERA reservation {reservationId} at hotel {hotelId}? List them.
Show sharers of booking {reservationId} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/{reservationId}/shares
Combine reservations into a share · Combine Share Reservations
#
Ask an LLM
“How do I put two guests in the same room as share reservations?”
“Can I combine a booking with another as sharers by internal ID?”
Tell an agent
Join OPERA reservation {reservationId} at hotel {hotelId} into a room share using {criteria}.
Make booking {reservationId} at hotel {hotelId} a share with another guest's reservation.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/shares
Separate share reservations · Separate share Reservations
#
Ask an LLM
“How do I break sharers apart into their own rooms?”
“Can I separate shares and get the remaining share reservations back?”
Tell an agent destructive · confirm first
Separate share reservations on reservation {reservationId} at hotel {hotelId}.
Break the share on booking {reservationId} at hotel {hotelId}, overriding max occupancy {override}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/stay/action/validate
Check one reservation for overlapping stays · Check overlapping stay
#
Ask an LLM
“Does this guest already have another stay overlapping this reservation?”
“Can I check a single booking for overlapping dates?”
Tell an agent
Check reservation {reservationId} at hotel {hotelId} for overlapping stays.
Validate overlap info {info} for booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/tickets
Get tickets on a reservation · Get tickets
#
Ask an LLM
“What event or attraction tickets are on this guest's booking?”
“Can I list only tickets that haven't been issued yet?”
Tell an agent
List tickets on reservation {reservationId} at hotel {hotelId}.
Show tickets for package {package} on booking {reservationId} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/{reservationId}/tickets
Create tickets on a reservation · Create tickets
#
Ask an LLM
“How do I add attraction tickets to a guest's reservation?”
“Can I create new tickets on a booking before issuing them?”
Tell an agent
Create tickets {tickets} on reservation {reservationId} at hotel {hotelId}.
Add new tickets to booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/tickets
Change tickets on a reservation · Change tickets
#
Ask an LLM
“How do I modify tickets already on a reservation?”
“Can I change the ticket details on a booking?”
Tell an agent
Update tickets {tickets} on reservation {reservationId} at hotel {hotelId}.
Change the existing tickets on booking {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/tickets
Delete tickets from a reservation · Delete tickets
#
Ask an LLM
“How do I delete tickets a guest no longer wants?”
“Can I remove all tickets from a booking?”
Tell an agent destructive · confirm first
Delete tickets from reservation {reservationId} at hotel {hotelId}.
Remove the tickets on booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/tickets/inquiry
Inquire about ticket status on a reservation · Inquiry for Reservation tickets
#
Ask an LLM
“What's the status of a specific ticket on a reservation?”
“Can I look up tickets by consumption date or rate code?”
Tell an agent
Run a ticket inquiry for ticket {ticketId} on reservation {reservationId} at hotel {hotelId}.
Inquire about tickets with status {status} on booking {reservationId} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/{reservationId}/tickets/issue
Issue tickets for a reservation · Issue Reservation tickets
#
Ask an LLM
“How do I issue the tickets a guest booked so they can use them?”
“Can I issue reservation tickets once they're created?”
Tell an agent
Issue tickets {tickets} for reservation {reservationId} at hotel {hotelId}.
Issue the pending tickets on booking {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/tickets/refund
Refund tickets on a reservation · Refund Reservation tickets
#
Ask an LLM
“How do I refund tickets a guest bought with their stay?”
“Can I refund issued reservation tickets?”
Tell an agent destructive · confirm first
Refund tickets on reservation {reservationId} at hotel {hotelId}.
Give the guest on booking {reservationId} at hotel {hotelId} a ticket refund.
GET
/hotels/{hotelId}/reservations/{reservationId}/tickets/reprint
Reprint tickets for a reservation · Reprints Reservation tickets
#
Ask an LLM
“A guest lost their ticket, can I reprint it?”
“Is it possible to reprint a single ticket by ticket number?”
Tell an agent
Reprint tickets for reservation {reservationId} at hotel {hotelId}.
Reprint ticket number {ticketNumber} on booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/traces
Get traces for a reservation · Get traces for a Reservation
#
Ask an LLM
“What follow-up traces are set on this guest's reservation?”
“Can I see department traces for a booking?”
Tell an agent
Get traces for reservation {reservationId} at hotel {hotelId}.
Show follow-up tasks traced on booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/transactionDiversions
Get transaction diversions on a reservation · Get Transaction Diversions
#
Ask an LLM
“Which transaction diversions apply to this reservation?”
“Can I include daily details when listing transaction diversions?”
Tell an agent
Get transaction diversions on reservation {reservationId} at hotel {hotelId}.
Show diversion codes {codes} with daily details for booking {reservationId} at hotel {hotelId}.
POST
/hotels/{hotelId}/reservations/{reservationId}/transactionDiversions
Create transaction diversions on a reservation · Create Transaction Diversions
#
Ask an LLM
“How do I add a transaction diversion to a reservation?”
“Can I set up new transaction diversions for a guest's stay?”
Tell an agent
Create transaction diversions {diversions} on reservation {reservationId} at hotel {hotelId}.
Add a new diversion to booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/transactionDiversions
Change transaction diversions on a reservation · Change Transaction Diversions
#
Ask an LLM
“How do I edit transaction diversions already on a booking?”
“Can I modify an existing transaction diversion?”
Tell an agent
Update transaction diversions {diversions} on reservation {reservationId} at hotel {hotelId}.
Change the existing diversions on booking {reservationId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/transactionDiversions
Delete transaction diversions from a reservation · Delete Transaction Diversions
#
Ask an LLM
“How do I remove transaction diversions from a booking?”
“Can I delete every transaction diversion on a reservation?”
Tell an agent destructive · confirm first
Delete transaction diversions on reservation {reservationId} at hotel {hotelId}.
Remove the diversions from booking {reservationId} at hotel {hotelId}.
PUT
/hotels/{hotelId}/reservations/{reservationId}/upgradeEligibleReservations
Set upgrade eligibility for reservations · Set Upgrade Eligibility for Reservations
#
Ask an LLM
“Can I flag reservations as eligible for a room upgrade?”
“How do I mark a booking as not upgrade eligible?”
Tell an agent
Set upgrade eligibility {eligibility} for reservation {reservationId} at hotel {hotelId}.
Mark booking {reservationId} at hotel {hotelId} as upgrade eligible.
POST
/hotels/{hotelId}/reservations/{reservationId}/upsell
Upsell a reservation to a better room · Upsell a Reservation
#
Ask an LLM
“How do I apply a paid room upgrade to a guest's reservation?”
“Can I override the upsell rules when upselling a booking?”
Tell an agent
Upsell reservation {reservationId} at hotel {hotelId} with offer {upsell}.
Apply the room upgrade to booking {reservationId} at hotel {hotelId}.
GET
/hotels/{hotelId}/reservations/{reservationId}/upsell
Get upsell offers available for a reservation · Get available Upsell offers
#
Ask an LLM
“What room upgrade offers can I pitch to this guest?”
“Are there any upsell options configured for this reservation?”
Tell an agent
Get available upsell offers for reservation {reservationId} at hotel {hotelId}.
Show upgrade offers the guest on booking {reservationId} at hotel {hotelId} qualifies for.
DELETE
/hotels/{hotelId}/reservations/{reservationId}/upsell
Remove an upsell from a reservation · Delete a Reservation Upsell
#
Ask an LLM
“How do I undo an upgrade that was sold on a reservation?”
“Can I remove an upsell and override inventory?”
Tell an agent destructive · confirm first
Delete the upsell on reservation {reservationId} at hotel {hotelId}.
Remove the upgrade from booking {reservationId} at hotel {hotelId}, overriding inventory {override}.
Ask an LLM
“Which rooms are assigned or free across the next few weeks?”
“Can I view the room calendar for one room type or floor?”
Tell an agent
Show the room calendar for hotel {hotelId} from {start} to {end}.
Get the room calendar at hotel {hotelId} for room type {roomType}.
Ask an LLM
“What traces are set on a particular room?”
“Can I see follow-up tasks tied to a room number rather than a booking?”
Tell an agent
Get traces for room {roomId} at hotel {hotelId}.
Show follow-ups logged against room {roomId} at hotel {hotelId}.
Ask an LLM
“What script should my agents read when taking a reservation?”
“Can I get the property script in another language?”
Tell an agent
Get the script for hotel {hotelId}.
Fetch the {type} script at hotel {hotelId} in language {lang}.
GET
/hotels/{hotelId}/sellMessages/config
Get a property's sell message configuration · Get sell messages
#
Ask an LLM
“Which sell messages are configured for my property?”
“Can I filter a hotel's sell message setup by room type or rate plan?”
Tell an agent
List sell message configuration at hotel {hotelId}.
Show sell message setup at hotel {hotelId} for rate plan {ratePlan}.
POST
/hotels/{hotelId}/sellMessages/config
Create a sell message for a property · Create sell message
#
Ask an LLM
“How do I add a new sell message agents see when booking my hotel?”
“Can I create property-specific sell messages by room type?”
Tell an agent
Create sell message configuration {configs} at hotel {hotelId}.
Add a new sell message for hotel {hotelId}.
Ask an LLM
“How do I edit a sell message shown to reservation agents at my hotel?”
“Can I update property-level sell message configuration?”
Tell an agent
Update sell message configuration {configs} at hotel {hotelId}.
Change the existing sell message text for hotel {hotelId}.
DELETE
/hotels/{hotelId}/sellMessages/config
Delete a property's sell message · Delete sell message
#
Ask an LLM
“How do I remove a sell message from my hotel's configuration?”
“Can I delete property-level sell messages?”
Tell an agent destructive · confirm first
Delete the sell message configuration at hotel {hotelId}.
Remove the property sell message for hotel {hotelId}.
PUT
/hotels/{hotelId}/stay/action/validate
Check prospective stays for overlaps at a hotel · Check overlapping stay
#
Ask an LLM
“Before booking, can I check whether a guest's new stay overlaps an existing one?”
“Is there a hotel-level overlapping stay check that doesn't need a reservation ID?”
Tell an agent
Before booking at hotel {hotelId}, run a property-level overlap check on {info}.
Validate that a new stay at hotel {hotelId} doesn't overlap the guest's other bookings.
Ask an LLM
“How do I record a guest we had to turn away because we were full?”
“Can I log turnaways for a single hotel for demand tracking?”
Tell an agent
Register turnaway {turnaway} at hotel {hotelId}.
Log a denied booking request at hotel {hotelId}.
GET
/profiles/{profileId}/reservations
Check a profile for future reservations or blocks · Get Future Reservations on a profile
#
Ask an LLM
“Does this guest profile have any upcoming reservations or business blocks?”
“Before merging a profile, can I see whether it has future bookings?”
Tell an agent
Check whether profile {profileId} has future reservations or blocks.
List upcoming stays tied to profile {profileId}.
GET
/recentlyAccessedReservations
Get recently accessed reservations · Get recently accessed Reservations
#
Ask an LLM
“Which reservations did I open most recently?”
“Can I list reservations accessed on a specific date?”
Tell an agent
Show my recently accessed reservations.
List reservations accessed on {date}, up to {limit}.
Ask an LLM
“How do I search reservations across several hotels at once?”
“Can I find bookings chain-wide by guest email or phone?”
Tell an agent
Find reservations across hotels {hotelIds} for surname {surname}.
List chain-wide reservations with confirmation number {confirmation}.
Ask an LLM
“What indicators, like traces or alerts, are flagged on a reservation?”
“Can I see the status flags for a booking at a glance?”
Tell an agent
Get indicators for reservation {reservationId} at hotel {hotelId}.
Show the flags set on booking {reservationId}.
POST
/reservations/linkedReservations/{reservationId}
Link reservations at chain level · Link Reservations By Chain
#
Ask an LLM
“Can I link reservations across properties at the chain level?”
“How do I link bookings without specifying a hotel in the path?”
Tell an agent
Link reservations {ids} to reservation {reservationId} at chain level.
Create a chain-level link from other bookings to {reservationId}.
DELETE
/reservations/linkedReservations/{reservationId}
Unlink a reservation at chain level · Remove Reservation Links By Chain
#
Ask an LLM
“Can I remove a reservation's links at the chain level without naming the hotel?”
“How do I unlink bookings that were linked across properties?”
Tell an agent destructive · confirm first
Remove chain-level links on reservation {reservationId}.
Unlink booking {reservationId} from its chain-level linked reservation.
POST
/reservations/searches
Search reservations across hotels via request body · Search Reservations for a hotel
#
Ask an LLM
“Is there a POST search for reservations across multiple hotels with criteria in the body?”
“Can I send a large chain-wide reservation search as a request body?”
Tell an agent
Run a body search of reservations across hotels {hotelIds} for surname {surname}.
Submit a multi-hotel reservation search for arrivals from {from} to {to}.
DELETE
/reservations/{reservationId}
Delete an on-hold reservation without a hotel path · Delete a Reservation
#
Ask an LLM
“Can I delete an in-session on-hold reservation using only its reservation ID?”
“Is there a chain-level way to discard an on-hold booking?”
Tell an agent destructive · confirm first
Delete on-hold reservation {reservationId} by ID alone.
Discard held in-session booking {reservationId} at the chain level.
PUT
/reservations/{reservationId}/split
Split a multi-room reservation · Split multi room Reservation
#
Ask an LLM
“How do I split a booking for three rooms into separate reservations?”
“Can I copy payment details when splitting a multi-room reservation?”
Tell an agent
Split multi-room reservation {reservationId}.
Split every room out of booking {reservationId} and copy payment info {copy}.
Ask an LLM
“What sell messages should an agent read out for this rate and room type?”
“Can I fetch the sell messages that apply to a stay's dates?”
Tell an agent
Get sell messages for hotel {hotelId} and rate plan {ratePlan}.
Show sell messages for room type {roomType} from {start} to {end}.
Ask an LLM
“Which sell messages are configured across my whole chain?”
“Can I filter chain sell message setup by CRO code?”
Tell an agent
List chain-level sell message configuration for chain {chainId}.
Show chain sell message setup for CRO {cro}.
Ask an LLM
“How do I add a sell message for every property in the chain?”
“Can I create sell messages at the chain level rather than per hotel?”
Tell an agent
Create chain-level sell message configuration {configs}.
Add a new chain-wide sell message.
Ask an LLM
“How do I update a sell message configured at the chain level?”
“Can I edit sell messages that apply across all my hotels?”
Tell an agent
Update chain-level sell message configuration {configs}.
Change the existing chain-wide sell message text.
Ask an LLM
“How do I remove a chain-level sell message configuration?”
“Can I delete one chain sell message by its config ID?”
Tell an agent destructive · confirm first
Delete chain sell message configuration {configId}.
Remove chain-wide sell message {configId}.
Ask an LLM
“Is the reservation service up, and which version is running?”
“Can I ping the OPERA reservation API for a health check?”
Tell an agent
Ping the reservation service.
Get the current reservation service version for hotel {hotel}.
Ask an LLM
“How do I log a turnaway for a destination or multiple properties at once?”
“Can a central reservations office record hub-level turnaways?”
Tell an agent
Register hub turnaway {turnaway} for CRO {cro}.
Log a destination-wide turnaway for multiple properties.
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