Oracle Hospitality Room Rotation Config API
The REST APIs allow you to perform all actions related to Room Rotation from configuring point calculations for owner rooms, adjustment options for room prioritization and automatic assignment based on owner room utilization.
Operations 30
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
GET
/adjustmentReasons
List room rotation adjustment reasons · Get Room Rotation Adjustment Reasons
#
Ask an LLM
“What adjustment reasons are configured for room rotation points?”
“Can I search rotation adjustment reasons by code or include inactive ones?”
Tell an agent
List the room rotation adjustment reasons.
Find rotation adjustment reasons matching code {code}.
POST
/adjustmentReasons
Create room rotation adjustment reasons · Post Room Rotation Adjustment Reasons
#
Ask an LLM
“How do I add a new reason for adjusting room rotation points?”
“Can I set up several rotation adjustment reason codes at once?”
Tell an agent
Create rotation adjustment reasons {reasons}.
Add a new room rotation adjustment reason code.
PUT
/adjustmentReasons/{adjustmentReasonsId}
Update a room rotation adjustment reason · Update Room Rotation Adjustment Reasons
#
Ask an LLM
“How do I edit the description of an existing rotation adjustment reason?”
“Can I change a rotation adjustment reason after it has been created?”
Tell an agent
Update rotation adjustment reason {reason_id}.
Change adjustment reason {reason_id} to {reasons}.
DELETE
/adjustmentReasons/{adjustmentReasonsId}
Delete a room rotation adjustment reason · Delete Room Rotation Adjustment Reasons
#
Ask an LLM
“How do I remove a rotation adjustment reason we no longer use?”
“Can I delete an adjustment reason by its code?”
Tell an agent destructive · confirm first
Delete rotation adjustment reason {reason_id}.
Remove adjustment reason {reason_id} with code {code}.
GET
/hotels/{hotelId}/revenueTransactionCodes
List room rotation revenue transaction codes · Retrieve all Room Rotation Revenue Transaction Codes
#
Ask an LLM
“Which transaction codes count as room rotation revenue at my hotel?”
“Can I list only the transaction codes flagged for rotation revenue?”
Tell an agent
List room rotation revenue transaction codes for hotel {hotel}.
Show transaction codes at hotel {hotel} where rotation revenue is {flag}.
PUT
/hotels/{hotelId}/revenueTransactionCodes
Set rotation revenue status on transaction codes · Update the room rotation revenue status of a set of transaction codes
#
Ask an LLM
“How do I mark transaction codes as counting toward room rotation revenue?”
“Can I change the rotation revenue flag on several transaction codes at once?”
Tell an agent
Update rotation revenue status of transaction codes at hotel {hotel}.
Set rotation revenue flags {codes} for hotel {hotel}.
GET
/hotels/{hotelId}/rotationPeriod
Get a hotel's room rotation period · Fetch Room Rotation Period
#
Ask an LLM
“What is the current room rotation period configured for a property?”
“When does the room rotation period start and end at my hotel?”
Tell an agent
Show the room rotation period for hotel {hotel}.
Fetch hotel {hotel}'s rotation period settings.
PUT
/hotels/{hotelId}/rotationPeriod
Change a hotel's room rotation period · Change Room Rotation Period
#
Ask an LLM
“How do I change the room rotation period for a property?”
“Can I reset the rotation period dates at my hotel?”
Tell an agent
Change the room rotation period for hotel {hotel}.
Set hotel {hotel}'s rotation period to {period}.
POST
/hotels/{hotelId}/rotationRules
Save rotation setup rules and recalculate points · Save changes to Rotation Setup Rules and recalculate Rotation Points
#
Ask an LLM
“How do I create, change or delete rotation setup rules and recalculate rotation points in one step?”
“Can I force a recalculation of rotation points after saving rule changes?”
Tell an agent
Save rotation setup rules {rules} for hotel {hotel} and recalculate points.
Apply rotation rule changes at hotel {hotel} with force recalculate {force}.
GET
/hotels/{hotelId}/rules
List room rotation setup rules · Retrieve all Room Rotation Setup Rules
#
Ask an LLM
“What room rotation setup rules are configured for my hotel?”
“Can I include inactive rotation rules or filter by setup type?”
Tell an agent
List the room rotation setup rules for hotel {hotel}.
Show rotation rules of setup type {setup_type} at hotel {hotel}.
POST
/hotels/{hotelId}/rules
Create rotation rules (deprecated endpoint) · Create Room Rotation Rules
#
Ask an LLM
“Is there an older deprecated endpoint that only creates room rotation rules without recalculating?”
“Can I still create rotation rules through the deprecated create-rules call?”
Tell an agent
Create rotation rules for hotel {hotel} using the deprecated create endpoint.
Add legacy rotation rules {rules} at hotel {hotel}.
DELETE
/hotels/{hotelId}/rules/{ruleId}
Delete a rotation rule (deprecated endpoint) · Delete an existing Room Rotation Rule
#
Ask an LLM
“How do I delete a single room rotation rule by its ID?”
“Can I remove a legacy rotation rule with the deprecated delete call?”
Tell an agent destructive · confirm first
Delete rotation rule {rule_id} at hotel {hotel}.
Remove legacy rule {rule_id} from hotel {hotel}.
PUT
/hotels/{hotelId}/rules/{ruleId}
Change a rotation rule (deprecated endpoint) · Change Room Rotation Rules
#
Ask an LLM
“How do I edit one rotation rule by its ID using the deprecated call?”
“Can I still update a single legacy rotation rule directly?”
Tell an agent
Change rotation rule {rule_id} at hotel {hotel} via the deprecated endpoint.
Update legacy rule {rule_id} for hotel {hotel} to {rules}.
GET
/hotels/{hotelId}/unitGrades
List owner room unit grades · Get Room Rotation Owner Room Grades
#
Ask an LLM
“What owner room grades are set up for room rotation?”
“Can I search owner room unit grades by code or description across hotels?”
Tell an agent
List owner room unit grades for hotel {hotel}.
Find unit grades matching code {code} at hotel {hotel}.
POST
/hotels/{hotelId}/unitGrades
Create an owner room unit grade · Create a new Room Rotation Owner Room Grade Code
#
Ask an LLM
“How do I add a new owner room grade code for room rotation?”
“Can I create unit grades for a specific property?”
Tell an agent
Create an owner room unit grade at hotel {hotel}.
Add unit grades {grades} for hotel {hotel}.
PUT
/hotels/{hotelId}/unitGrades/{unitGradeCode}
Change an owner room unit grade · Change an existing Room Rotation Owner Room Unit Grade
#
Ask an LLM
“How do I edit an existing owner room unit grade?”
“Can I change the description of a unit grade code?”
Tell an agent
Update unit grade {grade_code} at hotel {hotel}.
Change owner room grade {grade_code} at hotel {hotel} to {grades}.
DELETE
/hotels/{hotelId}/unitGrades/{unitGradeCode}
Delete an owner room unit grade · Delete an existing Room Rotation Owner Room Unit Grade
#
Ask an LLM
“How do I remove an owner room unit grade we no longer use?”
“Can I delete a unit grade code from one property?”
Tell an agent destructive · confirm first
Delete unit grade {grade_code} at hotel {hotel}.
Remove owner room grade {grade_code} from hotel {hotel}.
Ask an LLM
“Which reasons are configured for overriding the room rotation order?”
“Can I find rotation override reasons by description?”
Tell an agent
List the room rotation override reasons.
Find rotation override reasons with description {description}.
POST
/overrideReasons
Create a room rotation override reason · Create a new Room Rotation Override Reason
#
Ask an LLM
“How do I add a reason code for overriding room rotation?”
“Can I create new override reasons for skipping an owner's room?”
Tell an agent
Create rotation override reasons {reasons}.
Add a new room rotation override reason.
PUT
/overrideReasons/{overrideReasonsId}
Change a room rotation override reason · Change an existing Room Rotation Override Reason
#
Ask an LLM
“How do I edit an existing rotation override reason?”
“Can I update the description on an override reason?”
Tell an agent
Update rotation override reason {reason_id}.
Change override reason {reason_id} to {reasons}.
DELETE
/overrideReasons/{overrideReasonsId}
Delete a room rotation override reason · Delete an existing Room Rotation Override Reason
#
Ask an LLM
“How do I remove a rotation override reason?”
“Can I delete an override reason using its code?”
Tell an agent destructive · confirm first
Delete rotation override reason {reason_id}.
Remove override reason {reason_id} with code {code}.
GET
/profiles/{profileId}/roomOwnerReferrals
List a profile's room owner referrals · Get Profile Owner Referral Records
#
Ask an LLM
“Which referral records exist for a room owner's profile?”
“Can I include inactive owner referrals for a profile?”
Tell an agent
List room owner referrals for profile {profile_id}.
Show all owner referral records, active or not, for profile {profile_id}.
POST
/profiles/{profileId}/roomOwnerReferrals
Create room owner referrals · Create Room Owner Referrals
#
Ask an LLM
“How do I record that a room owner referred guests to the property?”
“Can I add several owner referral records to a profile at once?”
Tell an agent
Create room owner referrals for profile {profile_id}.
Add referrals {referrals} to owner profile {profile_id}.
PUT
/profiles/{profileId}/roomOwnerReferrals/{roomOwnerReferralId}
Change a room owner referral · Change Room Owner Referral Record
#
Ask an LLM
“How do I correct an existing room owner referral record?”
“Can I update a single owner referral by its ID?”
Tell an agent
Update referral {referral_id} on profile {profile_id}.
Change owner referral {referral_id} for profile {profile_id} to {referral}.
DELETE
/profiles/{profileId}/roomOwnerReferrals/{roomOwnerReferralId}
Delete a room owner referral · Delete Room Owner Referral Record
#
Ask an LLM
“How do I remove a room owner referral that was entered by mistake?”
“Can I delete one referral record from an owner profile?”
Tell an agent destructive · confirm first
Delete referral {referral_id} from profile {profile_id}.
Remove owner referral record {referral_id} on profile {profile_id}.
GET
/profiles/{profileId}/roomOwners
List a profile's room ownership records · Get Profile Room Ownership Records
#
Ask an LLM
“Which rooms does an owner profile own for room rotation?”
“Can I include inactive room ownership records for a profile?”
Tell an agent
List room ownership records for profile {profile_id}.
Show rooms owned by profile {profile_id}, including inactive owners {inactive}.
Ask an LLM
“How do I register an owner for a condo or rotation room?”
“Can I create a room ownership record that overrides owner exclusivity?”
Tell an agent
Create room ownership record {owner}.
Add a new room owner {owner} overriding exclusivity {override}.
Ask an LLM
“How do I update several room ownership records across properties at once?”
“Can I override owner exclusivity when changing room ownership?”
Tell an agent
Update room ownership records {owners}.
Change room owners {owners} with override exclusive set to {override}.
DELETE
/roomOwners/{roomOwnershipId}
Delete a room ownership record · Delete Room Ownership Record
#
Ask an LLM
“How do I remove an owner from a room ownership record?”
“Can I delete room ownership even if referrals exist?”
Tell an agent destructive · confirm first
Delete room ownership record {ownership_id}.
Remove ownership {ownership_id} and skip the referral check {skip}.
Ask an LLM
“Is the room rotation configuration service responding?”
“How do I health-check room rotation config?”
Tell an agent
Ping the room rotation config service.
Check room rotation service status for hotel {hotel}.
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