Oracle Hospitality

Oracle Hospitality Housekeeping API

These APIs allows for retrieving and managing a room's housekeeping data and front office status, for example update room 101 to be Out Of Order. Additionally, you can view room discrepancies between housekeeping and front office statuses, view and update task sheets and create a room service request.

GitHub OpenAPI
Business capability
Housekeeping Operations BC-4060.20

Operations 60

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 /hotels/{hotelId}/attendants/houseKeepingTasks View the housekeeping attendants' work schedule · Get the housekeeping attendants schedule #
Ask an LLM
“Which housekeeping attendants are scheduled to work at my hotel next week?”
“Can I see the attendant schedule for up to a 30-day date range?”
Tell an agent
Show the housekeeping attendant schedule for hotel {hotelId} starting {scheduleStartDate}.
List which attendants are rostered at {hotelId} between {scheduleStartDate} and {scheduleEndDate}.
DELETE /hotels/{hotelId}/attendants/houseKeepingTasks Remove an attendant's schedule for a day · Delete housekeeping attendant schedule #
Ask an LLM
“How do I take a housekeeping attendant off the schedule for a specific day?”
“Can I delete one attendant's shift without touching the rest of the roster?”
Tell an agent destructive · confirm first
Delete attendant {attendantId}'s housekeeping schedule on {scheduleDate} at hotel {hotelId}.
Unschedule attendant {attendantId} for {scheduleDate}.
POST /hotels/{hotelId}/autoTaskSheets Automatically generate housekeeping task sheets · Auto generate the task sheets #
Ask an LLM
“Can OPERA build the day's housekeeping task sheets for me automatically?”
“Is there a way to auto-split rooms into attendant task sheets instead of making them by hand?”
Tell an agent
Auto-generate today's housekeeping task sheets for hotel {hotelId}.
Automatically create attendant task sheets for {hotelId} using the default criteria.
GET /hotels/{hotelId}/conditions List rooms that have a room condition set · Get rooms condition #
Ask an LLM
“Which rooms at my hotel currently have a condition like show room or set aside?”
“Can I filter rooms by condition, floor or room type to see which ones are flagged?”
Tell an agent
List rooms with a condition set at hotel {hotelId}.
Show rooms on floor {floors} at {hotelId} that carry condition {roomConditions}.
PUT /hotels/{hotelId}/conditions Set, change or clear a condition on rooms · Set rooms condition #
Ask an LLM
“How do I mark a room as set aside for a show or special use?”
“Can I change or clear the condition that's on a room?”
Tell an agent
Set a room condition on the selected rooms at hotel {hotelId}.
Clear the existing condition from the rooms I specify at {hotelId}.
GET /hotels/{hotelId}/forecastTaskSchedules Forecast housekeeping attendants and tasks needed · Get facility forecast #
Ask an LLM
“How many housekeeping attendants will I need over the next few days?”
“Can I forecast facility tasks for a future start date and duration?”
Tell an agent
Get the housekeeping facility forecast for hotel {hotelId} from {startDate} to {endDate}.
Forecast attendant and task needs at {hotelId} for {duration} days starting {startDate}.
DELETE /hotels/{hotelId}/houseKeepingTasks/{taskCodesBreakOutId} Delete every task sheet in a task sheet set · Delete all the hotel task sheets for an existing Task Sheet Set #
Ask an LLM
“Can I wipe out all task sheets in a task sheet set at once?”
“What happens if I delete a whole task sheet set's sheets and need to regenerate them?”
Tell an agent destructive · confirm first
Delete all task sheets in task sheet set {taskCodesBreakOutId} at hotel {hotelId}.
Remove every sheet belonging to break-out set {taskCodesBreakOutId}.
GET /hotels/{hotelId}/houseKeepingtasks Get the existing housekeeping task sheets for a date · Get the existing task sheets #
Ask an LLM
“What task sheets have been created for housekeeping today?”
“Can I get the task sheets sorted by cleaning sequence with reservation info included?”
Tell an agent
Show the housekeeping task sheets for hotel {hotelId} on {taskDate}.
Get {taskDate}'s task sheets for task code {taskCodes}, sorted by cleaning sequence.
GET /hotels/{hotelId}/housekeepingDiscrepancies Find rooms with housekeeping status discrepancies · Get hotel housekeeping discrepant rooms #
Ask an LLM
“Which rooms have a mismatch between housekeeping and front office status, like a skip or sleep?”
“Can I list discrepant rooms on one floor or only those due out?”
Tell an agent
List housekeeping discrepant rooms at hotel {hotelId}.
Show rooms with discrepancy status {roomDiscrepancyStatus} on floor {floor}.
GET /hotels/{hotelId}/housekeepingOverview Get an overview of room housekeeping statuses · Get housekeeping rooms overview #
Ask an LLM
“What's the current clean, dirty or inspected status of every room in the hotel?”
“Can I see turndown and service request status alongside room status in one view?”
Tell an agent
Give me the housekeeping rooms overview for hotel {hotelId}.
Show rooms at {hotelId} whose housekeeping status is {housekeepingRoomStatus}.
DELETE /hotels/{hotelId}/maintenances/{mainteananceId} Delete a room maintenance record · Delete the maintenances for rooms #
Ask an LLM
“How do I delete a maintenance entry that was logged against a room by mistake?”
“Can a room maintenance request be removed entirely rather than resolved?”
Tell an agent destructive · confirm first
Delete maintenance {mainteananceId} at hotel {hotelId}.
Remove room maintenance record {mainteananceId} permanently.
PUT /hotels/{hotelId}/maintenances/{mainteananceId}/resolve Mark a room maintenance request as resolved · Resolve maintenances for rooms #
Ask an LLM
“How do I close out a room maintenance issue once engineering has fixed it?”
“Can I mark a maintenance request on a room as resolved?”
Tell an agent
Resolve maintenance {mainteananceId} at hotel {hotelId}.
Mark room maintenance {mainteananceId} as fixed.
PUT /hotels/{hotelId}/maintenances/{mainteananceId}/unResolve Reopen a resolved room maintenance request · unResolve the maintenances for rooms #
Ask an LLM
“What if a maintenance issue was marked resolved but the problem came back?”
“Can I undo the resolved status on a room maintenance request?”
Tell an agent
Unresolve maintenance {mainteananceId} at hotel {hotelId}.
Reopen resolved room maintenance {mainteananceId}.
PUT /hotels/{hotelId}/moveTaskRooms Move rooms between housekeeping task sheets · Move the task rooms #
Ask an LLM
“Can I move a room from one attendant's task sheet to another's?”
“How would I rebalance rooms across task sheets after they're generated?”
Tell an agent
Move the selected task sheet rooms to another sheet at hotel {hotelId}.
Reassign rooms between attendants' task sheets at {hotelId}.
GET /hotels/{hotelId}/reservations/{reservationId}/houseKeepingNotes Read a guest's housekeeping instructions · Get the guest housekeeping instructions #
Ask an LLM
“Did this guest leave any housekeeping instructions, like do not disturb or service times?”
“What housekeeping notes are on a reservation?”
Tell an agent
Show the guest housekeeping instructions on reservation {reservationId} at hotel {hotelId}.
Get housekeeping notes for reservation {reservationId}.
PUT /hotels/{hotelId}/reservations/{reservationId}/houseKeepingNotes Set a guest's housekeeping instructions · Set guest housekeeping instructions #
Ask an LLM
“How do I record that a guest wants housekeeping only in the afternoon?”
“Can I add housekeeping instructions to a reservation?”
Tell an agent
Set housekeeping instructions {guestHousekeepingInstructions} on reservation {reservationId}.
Save guest housekeeping notes for reservation {reservationId} at hotel {hotelId}.
GET /hotels/{hotelId}/reservations/{reservationId}/houseKeepingTaskSchedules View a reservation's housekeeping schedule · Get reservation housekeeping schedule #
Ask an LLM
“When is housekeeping scheduled to service this guest's room during their stay?”
“Can I see a reservation's cleaning schedule between two dates?”
Tell an agent
Show the housekeeping schedule for reservation {reservationId} at hotel {hotelId}.
Get reservation {reservationId}'s housekeeping tasks from {beginDate} to {endDate}.
POST /hotels/{hotelId}/reservations/{reservationId}/houseKeepingTaskSchedules Add housekeeping tasks to a reservation · Create reservation housekeeping tasks #
Ask an LLM
“How do I schedule extra housekeeping tasks for a guest's reservation?”
“Can I create a new cleaning task schedule for a reservation that has none?”
Tell an agent
Create housekeeping tasks for reservation {reservationId} at hotel {hotelId}.
Add a new housekeeping schedule {housekeepingSchedule} to reservation {reservationId}.
PUT /hotels/{hotelId}/reservations/{reservationId}/houseKeepingTaskSchedules Update a reservation's scheduled housekeeping tasks · Update reservation housekeeping tasks #
Ask an LLM
“Can I change the housekeeping tasks already scheduled for a guest's stay?”
“How would I edit the cleaning frequency on an existing reservation schedule?”
Tell an agent
Update the existing housekeeping tasks on reservation {reservationId} at hotel {hotelId}.
Change reservation {reservationId}'s housekeeping schedule to {housekeepingSchedule}.
DELETE /hotels/{hotelId}/reservations/{reservationId}/houseKeepingTaskSchedules Delete a housekeeping task from a reservation · Delete reservation housekeeping task #
Ask an LLM
“Can I remove a scheduled housekeeping task from a guest's stay?”
“What do I specify to delete one facility task on a reservation by task code and date?”
Tell an agent destructive · confirm first
Delete the housekeeping task on reservation {reservationId} at hotel {hotelId}.
Remove task {facilityTaskCode} on {taskDate} from reservation {reservationId}.
PUT /hotels/{hotelId}/reservations/{reservationId}/houseKeepingTaskSchedules/reset Reset a reservation's housekeeping schedule · Reset reservation housekeeping schedule #
Ask an LLM
“How do I put a reservation's cleaning schedule back to the default?”
“Can I undo custom housekeeping changes on a guest's stay?”
Tell an agent
Reset the housekeeping schedule for reservation {reservationId} at hotel {hotelId}.
Restore reservation {reservationId}'s default cleaning schedule.
PUT /hotels/{hotelId}/reservations/{reservationId}/houseKeepingTaskSchedules/shift Shift a reservation's housekeeping schedule · Shift reservation housekeeping schedule #
Ask an LLM
“The guest's dates moved; can I shift their housekeeping schedule to match?”
“Is it possible to push a reservation's cleaning days later?”
Tell an agent
Shift the housekeeping schedule for reservation {reservationId} at hotel {hotelId}.
Move reservation {reservationId}'s cleaning days forward.
DELETE /hotels/{hotelId}/rooms/cleaningPriority Remove a room's cleaning priority · Delete room cleaning priority #
Ask an LLM
“How do I take a room off the priority cleaning list?”
“Can I clear the rush-clean priority once a room no longer needs it?”
Tell an agent destructive · confirm first
Remove the cleaning priority from room {roomId} at hotel {hotelId}.
Clear priority cleaning on room {roomId}.
POST /hotels/{hotelId}/rooms/maintenanceCodes/{maintenanceCode} Log a maintenance request against rooms · Create maintenances for rooms #
Ask an LLM
“How do I report a broken AC or leaky tap as a maintenance issue on a room?”
“Can I log the same maintenance code on several rooms at once?”
Tell an agent
Create a maintenance request with code {maintenanceCode} for rooms at hotel {hotelId}.
Log maintenance {maintenanceCode} on the rooms I list.
GET /hotels/{hotelId}/rooms/maintenances List rooms with maintenance requests · Get the maintenance rooms #
Ask an LLM
“Which rooms have open maintenance issues right now?”
“Can I filter room maintenance by code, status or who it's assigned to?”
Tell an agent
List rooms with maintenance at hotel {hotelId}.
Show room maintenance with status {roomMaintenanceStatus} and code {maintenanceCodes}.
GET /hotels/{hotelId}/rooms/outOfOrderRooms List rooms that are Out of Order · Get Out of Order Rooms #
Ask an LLM
“Which rooms are Out of Order and can't be sold right now?”
“Can I narrow the Out of Order list by room class or room type?”
Tell an agent
List Out of Order rooms at hotel {hotelId} from {startDate}.
Show Out of Order rooms of type {roomTypes} between {startDate} and {endDate}.
PUT /hotels/{hotelId}/rooms/outOfOrderRooms Return Out of Order rooms to service · Complete rooms Out Of Order #
Ask an LLM
“How do I put an Out of Order room back into inventory once it's repaired?”
“What status does a room get when it's no longer Out of Order?”
Tell an agent
Complete the Out of Order period on the rooms I specify at hotel {hotelId}.
Release Out of Order rooms at {hotelId} and mark them available for guests.
POST /hotels/{hotelId}/rooms/outOfOrderRooms Set rooms to Out of Order · Set multiple rooms to Out Of Order #
Ask an LLM
“How do I take several rooms Out of Order for a renovation?”
“Can I update an existing Out of Order period on a room?”
Tell an agent
Set the rooms I list to Out of Order at hotel {hotelId}.
Put rooms at {hotelId} Out of Order for the dates and reason I give.
PUT /hotels/{hotelId}/rooms/outOfServiceRooms Return Out of Service rooms to use · Complete Rooms Out of Service #
Ask an LLM
“How do I end the Out of Service status on a room that's ready again?”
“What housekeeping status should a room take when it comes back from Out of Service?”
Tell an agent
Complete the Out of Service period on the rooms I specify at hotel {hotelId}.
Bring Out of Service rooms at {hotelId} back into use.
GET /hotels/{hotelId}/rooms/outOfServiceRooms List rooms that are Out of Service · Get Out of Service Rooms #
Ask an LLM
“Which rooms are Out of Service at the moment?”
“Can I see Out of Service rooms for a date range, filtered by room class?”
Tell an agent
List Out of Service rooms at hotel {hotelId} from {startDate}.
Show Out of Service rooms in class {roomClasses} between {startDate} and {endDate}.
POST /hotels/{hotelId}/rooms/outOfServiceRooms Set rooms to Out of Service · Set multiple rooms to Out Of Service #
Ask an LLM
“Can I mark a few rooms Out of Service rather than Out of Order?”
“How do I change the dates on an existing Out of Service room?”
Tell an agent
Set the rooms I list to Out of Service at hotel {hotelId}.
Mark rooms at {hotelId} Out of Service, not Out of Order, for the dates and reason I give.
PUT /hotels/{hotelId}/rooms/status Update housekeeping status for multiple rooms · Update Housekeeping Room Status #
Ask an LLM
“How do I mark a batch of rooms as clean or inspected?”
“Can I update turndown status along with the housekeeping status?”
Tell an agent
Set rooms {roomList} to housekeeping status {housekeepingRoomStatus}.
Mark the rooms I list at hotel {hotelId} as dirty.
PUT /hotels/{hotelId}/rooms/{roomId}/cleaningPriority Give a room cleaning priority · Set the room cleaning priority #
Ask an LLM
“How do I flag a room so housekeeping cleans it first?”
“Can I rush a room for an early arrival?”
Tell an agent
Set cleaning priority on room {roomId} at hotel {hotelId}.
Make room {roomId} a priority clean.
PUT /hotels/{hotelId}/rooms/{roomId}/maintenances/{maintenanceId} Change a maintenance request on a room · Change maintenances for rooms #
Ask an LLM
“Can I edit the details of a maintenance request already logged on a room?”
“How would I reassign or update an existing room maintenance entry?”
Tell an agent
Update maintenance {maintenanceId} on room {roomId} at hotel {hotelId}.
Change the details of room {roomId}'s maintenance {maintenanceId}.
PUT /hotels/{hotelId}/rooms/{roomId}/sheets/{sheetNumber} Cancel servicing of a room on a task sheet · Cancel servicing task room #
Ask an LLM
“An attendant started a room by mistake; can I cancel the servicing?”
“How do I cancel service on a room that's on a task sheet?”
Tell an agent
Cancel servicing of room {roomId} on task sheet {sheetNumber} at hotel {hotelId}.
Stop the in-progress service on room {roomId}, sheet {sheetNumber}.
PUT /hotels/{hotelId}/rooms/{roomId}/sheets/{sheetNumber}/complete Mark a task sheet room as serviced · Complete servicing task room #
Ask an LLM
“How does an attendant record that they finished cleaning a room?”
“Can I complete a room on a task sheet from a mobile app?”
Tell an agent
Complete servicing of room {roomId} on task sheet {sheetNumber} at hotel {hotelId}.
Mark room {roomId} on sheet {sheetNumber} as done.
PUT /hotels/{hotelId}/rooms/{roomId}/sheets/{sheetNumber}/skip Skip a room on a housekeeping task sheet · Skip servicing task room #
Ask an LLM
“What if the attendant can't get into a room; can they skip it?”
“Can I skip a room on a task sheet and come back later?”
Tell an agent
Skip room {roomId} on task sheet {sheetNumber} at hotel {hotelId}.
Pass over room {roomId} on sheet {sheetNumber} for now.
PUT /hotels/{hotelId}/rooms/{roomId}/sheets/{sheetNumber}/start Start servicing a room on a task sheet · Start servicing task room #
Ask an LLM
“How does an attendant clock in to a room when they begin cleaning?”
“Can I record that servicing has started on a task sheet room?”
Tell an agent
Start servicing room {roomId} on task sheet {sheetNumber} at hotel {hotelId}.
Begin cleaning room {roomId} on sheet {sheetNumber}.
POST /hotels/{hotelId}/schedules/houseKeepingTasks Schedule housekeeping attendants · Create housekeeping attendant schedule #
Ask an LLM
“How do I roster housekeeping attendants for upcoming days?”
“Can I add attendants to the housekeeping work schedule?”
Tell an agent
Create a housekeeping attendant schedule at hotel {hotelId}.
Add attendant shifts {attendantsScheduleInfo} to the housekeeping roster.
PUT /hotels/{hotelId}/serviceRequests Set guest housekeeping service requests on rooms · Set the Guest housekeeping service requests #
Ask an LLM
“How do I mark a room as Do Not Disturb or Make Up Room?”
“Can I record a guest's housekeeping service request status?”
Tell an agent
Set the guest housekeeping service request on the rooms I list at hotel {hotelId}.
Flag the given rooms at {hotelId} as Make Up Room.
GET /hotels/{hotelId}/sheets/{sheetNumber} Get an attendant's task companion view of a sheet · Get task companion #
Ask an LLM
“What rooms does an attendant still have left on their task sheet?”
“Can the task companion include maintenance and queue details for each room?”
Tell an agent
Open the task companion for sheet {sheetNumber} with task code {taskCodes} at hotel {hotelId}.
Show attendant sheet {sheetNumber}'s rooms for task {taskCodes} on {taskDate}, including completed rooms.
PUT /hotels/{hotelId}/taskSheet/{taskSequenceNumber}/complete Complete a single housekeeping task sheet · Complete a task sheet #
Ask an LLM
“How do I close out one attendant's task sheet at the end of the shift?”
“Does completing a task sheet require the Task Sheet Completion control to be on?”
Tell an agent
Complete task sheet {taskSequenceNumber} at hotel {hotelId}.
Mark task sheet number {taskSequenceNumber} as finished.
PUT /hotels/{hotelId}/taskSheet/{taskSequenceNumber}/reopen Reopen a completed task sheet · Reopen a task sheet #
Ask an LLM
“Can I reopen a single task sheet that was completed too early?”
“What do I need to reopen one attendant's sheet after it's been closed?”
Tell an agent
Reopen task sheet {taskSequenceNumber} at hotel {hotelId}.
Undo completion on task sheet number {taskSequenceNumber}.
PUT /hotels/{hotelId}/taskSheetSet/{taskCodesBreakOutId}/complete Complete all task sheets in a task sheet set · Complete all the hotel's task sheets for an existing Task Sheet Set #
Ask an LLM
“Can I complete every task sheet in a set in one go?”
“How do I close all the sheets in a task sheet set at end of day?”
Tell an agent
Complete all task sheets in set {taskCodesBreakOutId} at hotel {hotelId}.
Close out the whole task sheet set {taskCodesBreakOutId}.
PUT /hotels/{hotelId}/taskSheetSet/{taskCodesBreakOutId}/reopen Reopen all task sheets in a task sheet set · Reopen all the hotel's task sheets for an existing Task Sheet Set #
Ask an LLM
“Is there a way to reopen a whole task sheet set after it was completed?”
“Can every sheet in a completed set be reopened together?”
Tell an agent
Reopen all task sheets in set {taskCodesBreakOutId} at hotel {hotelId}.
Reopen the entire task sheet set {taskCodesBreakOutId}.
GET /hotels/{hotelId}/taskSheetTemplates List housekeeping task sheet templates · Get the task sheet templates #
Ask an LLM
“What task sheet templates are set up for housekeeping?”
“Can I look up a single task sheet template by its code?”
Tell an agent
List task sheet templates for hotel {hotelId}.
Get task sheet template {templateCode}.
PUT /hotels/{hotelId}/taskSheetTemplates/{taskSheetTemplateCode} Change a task sheet template · Change the task sheet templates #
Ask an LLM
“How do I edit the rooms or settings on a task sheet template?”
“Can I update a saved task sheet template?”
Tell an agent
Update task sheet template {taskSheetTemplateCode} at hotel {hotelId}.
Change template {taskSheetTemplateCode}'s details to {taskSheetTemplateDetails}.
DELETE /hotels/{hotelId}/taskSheetTemplates/{taskSheetTemplateCode} Delete a task sheet template · Delete task sheet templates #
Ask an LLM
“Can I delete a task sheet template we no longer use?”
“What happens when I remove a housekeeping task sheet template?”
Tell an agent destructive · confirm first
Delete task sheet template {taskSheetTemplateCode} at hotel {hotelId}.
Remove template {taskSheetTemplateCode}.
POST /hotels/{hotelId}/taskSheets Create a housekeeping task sheet · Create the task sheet #
Ask an LLM
“How do I create a new task sheet by hand for an attendant?”
“Can I add a manual housekeeping task sheet for today?”
Tell an agent
Create a new task sheet at hotel {hotelId}.
Add a manual task sheet with details {taskSheetDetails}.
PUT /hotels/{hotelId}/taskSheets Change an existing housekeeping task sheet · Change the task sheet #
Ask an LLM
“Can I change the attendant or details on an existing task sheet?”
“How do I edit a task sheet after it's been created?”
Tell an agent
Update the task sheet details at hotel {hotelId}.
Change task sheet details to {taskSheetDetails}.
DELETE /hotels/{hotelId}/taskSheets Delete a housekeeping task sheet · Delete the task sheet #
Ask an LLM
“Can I delete one task sheet I created by mistake?”
“What do I need to identify a task sheet for deletion?”
Tell an agent destructive · confirm first
Delete task sheet {sheetNumber} for task code {taskCodes} at hotel {hotelId}.
Remove sheet {sheetNumber} ({taskCodes}) dated {date}.
PUT /hotels/{hotelId}/taskSheets/rooms Change the rooms on a task sheet · Change the task sheet rooms #
Ask an LLM
“Can I change which rooms are on an attendant's task sheet?”
“How do I update room details on an existing task sheet?”
Tell an agent
Update the rooms on a task sheet at hotel {hotelId}.
Change the task sheet's room list to {taskSheetDetails}.
DELETE /hotels/{hotelId}/taskSheets/rooms Remove rooms from a task sheet · Delete task sheet rooms #
Ask an LLM
“Can I take a single room off an attendant's task sheet?”
“Which details identify the room to drop from a task sheet?”
Tell an agent destructive · confirm first
Remove room {roomId} from task sheet {sheetNumber} ({taskCodes}) at hotel {hotelId}.
Delete the rooms on sheet {sheetNumber} for task {taskCodes}.
POST /hotels/{hotelId}/taskSheets/rooms Add rooms to a task sheet · Create the task sheet rooms #
Ask an LLM
“How do I add a room to an attendant's task sheet?”
“Can extra rooms be added to a task sheet after it's generated?”
Tell an agent
Add rooms to a task sheet at hotel {hotelId}.
Put the rooms in {taskSheetDetails} onto the task sheet.
PUT /hotels/{hotelId}/taskSheets/{sheetNumber}/lock Lock a housekeeping task sheet · Lock the task sheet #
Ask an LLM
“How do I lock a task sheet so nobody changes it?”
“Can I prevent edits to an attendant's sheet once it's final?”
Tell an agent
Lock task sheet {sheetNumber} at hotel {hotelId}.
Freeze sheet {sheetNumber} against changes.
PUT /hotels/{hotelId}/taskSheets/{sheetNumber}/unlock Unlock a housekeeping task sheet · Unlock the task sheet #
Ask an LLM
“Can a locked task sheet be unlocked for edits?”
“What do I do to make a locked sheet editable again?”
Tell an agent
Unlock task sheet {sheetNumber} at hotel {hotelId}.
Allow edits on locked sheet {sheetNumber}.
PUT /hotels/{hotelId}/taskSheets/{taskSheetNumber}/end End an attendant's service break · End the service break #
Ask an LLM
“How does an attendant log that they're back from a break?”
“Can I end an attendant's service break on their task sheet?”
Tell an agent
End the service break on task sheet {taskSheetNumber} at hotel {hotelId}.
Resume work for the attendant on sheet {taskSheetNumber}.
PUT /hotels/{hotelId}/taskSheets/{taskSheetNumber}/start Start an attendant's service break · Start the service break #
Ask an LLM
“How does an attendant record going on a break mid-shift?”
“Can breaks be tracked against a housekeeping task sheet?”
Tell an agent
Start a service break on task sheet {taskSheetNumber} at hotel {hotelId}.
Put the attendant on sheet {taskSheetNumber} on break.
POST /hotels/{hotelId}/taskSheets/{toTaskSequenceNo}/merge Merge task sheets into one · Merge task sheet #
Ask an LLM
“An attendant called in sick; can I merge their sheet into someone else's?”
“How do I combine two housekeeping task sheets?”
Tell an agent
Merge task sheets into sheet {toTaskSequenceNo} at hotel {hotelId}.
Combine the selected sheets into task sheet {toTaskSequenceNo}.
GET /services/houseKeeping/status Check the housekeeping service is up · ping the house keeping service #
Ask an LLM
“Is the OPERA housekeeping service up and responding?”
“Can I health-check the housekeeping API before calling it?”
Tell an agent
Ping the housekeeping service.
Check whether the housekeeping API is available for hotel {hotelid}.

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

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/openapi/oracle-hospitality-housekeeping-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/oracle-hospitality:oracle-hospitality-housekeeping-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

oracle-hospitality-housekeeping-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: OPERA Cloud Service Housekeeping API
  description: 'APIs to cater for Housekeeping functionality in OPERA Cloud.


    Housekeeping enables you to schedule daily room cleaning, maintenance, and housekeeping staff activities. It provides information on room status, out of order/out of service rooms, and forecasting.


    Compatible with OPERA Cloud release 26.2.0.0.


    This document and all content within is available under the Universal Permissive License v 1.0 (https://oss.oracle.com/licenses/upl). Copyright (c) 2020, 2026 Oracle and/or its affiliates.'
  version: 26.2.0.0
  termsOfService: https://www.oracle.com/legal/terms.html
  contact:
    email: hospitality_apis_ww_grp@oracle.com
  license:
    name: UPL
    url: https://opensource.org/licenses/upl
servers:
- url: /hsk/v1
tags:


# --- truncated at 32 KB (424 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/openapi/oracle-hospitality-housekeeping-api-openapi.yml