API Evangelist conversational phrasing for OPERA Cloud Service Front Desk Operations API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for OPERA Cloud Service Front Desk Operations API
  version: 1.0.0
extends: openapi/oracle-hospitality-frontdeskoperations-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 61
- target: $.paths['/hotels/{hotelId}/authorizationReservations'].get
  update:
    x-apievangelist-phrasing:
      intent: Find reservations due a batch card authorization
      effect: read
      questions:
      - Which reservations still need their credit card authorized in the nightly batch?
      - Can I narrow batch authorization candidates by card type or arrival dates?
      instructions:
      - text: List reservations eligible for batch credit card authorization at hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Show batch card authorization candidates at {hotel} arriving between {start} and {end}.
        slots:
          hotel: path.hotelId
          start: query.arrivalStartDate
          end: query.arrivalEndDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/batchReservationAuthorizations'].put
  update:
    x-apievangelist-phrasing:
      intent: Run batch credit card authorization
      effect: write
      questions:
      - How do I authorize credit cards for many reservations in one run?
      - Can I submit a list of reservations for batch card authorization?
      instructions:
      - text: Process batch credit card authorization at hotel {hotel} for reservations {reservations}.
        slots:
          hotel: path.hotelId
          reservations: requestBody.reservations
      - text: Run the batch card authorization for tonight's arrivals at {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/billingReservations'].get
  update:
    x-apievangelist-phrasing:
      intent: Find reservations ready for billing
      effect: read
      questions:
      - Which reservations have open folios that the cashier needs to bill?
      - What is the maximum date span when searching reservations for billing?
      - Can I search billing reservations by guest surname or room number?
      instructions:
      - text: List reservations for billing at hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Find billing reservations at {hotel} for guest surname {surname} with open folios.
        slots:
          hotel: path.hotelId
          surname: query.surname
      - text: Show reservations to bill at {hotel} departing between {start} and {end}.
        slots:
          hotel: path.hotelId
          start: query.departureStart
          end: query.departureEnd
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/dailyDocket'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the daily docket
      effect: read
      questions:
      - What is on today's daily docket for the front office?
      - Can I pull the daily docket for one department on a given date?
      instructions:
      - text: Get the daily docket at hotel {hotel} for {date}.
        slots:
          hotel: path.hotelId
          date: query.docketDate
      - text: Show the {department} department's daily docket at {hotel}.
        slots:
          department: query.department
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/dailyDocket'].put
  update:
    x-apievangelist-phrasing:
      intent: Change daily docket entries
      effect: write
      questions:
      - Can I edit entries already on the daily docket?
      - How do I correct a daily docket entry after it was created?
      instructions:
      - text: Update the existing daily docket entries at hotel {hotel} with {entries}.
        slots:
          hotel: path.hotelId
          entries: requestBody.dailyDocketEntries
      - text: Edit today's docket entry at {hotel} to change its department.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/dailyDocket'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a daily docket entry
      effect: write
      questions:
      - What do I send to add a new item to the daily docket?
      - Can I create several daily docket entries in one request?
      instructions:
      - text: Create a new daily docket at hotel {hotel} with {entries}.
        slots:
          hotel: path.hotelId
          entries: requestBody.dailyDocketEntries
      - text: Add a new docket entry at {hotel} for the VIP arrival.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/dailyDocket/{docketId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a daily docket
      effect: destructive
      questions:
      - How do I remove a daily docket that is no longer needed?
      - Can I delete a single docket by its id?
      instructions:
      - text: Delete daily docket {docket} at hotel {hotel}.
        slots:
          docket: path.docketId
          hotel: path.hotelId
      - text: Remove docket {docket}.
        slots:
          docket: path.docketId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalRoomKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Request room keys from an external door lock
      effect: write
      questions:
      - How does OPERA Cloud send a key request to an external door lock system via outbound configuration?
      - Which encoder and key type fields are required for an external room key request?
      instructions:
      - text: Send an external door lock key request at hotel {hotel} on encoder {encoder} terminal {terminal} with key type {keyType}.
        slots:
          hotel: path.hotelId
          encoder: requestBody.encoderId
          terminal: requestBody.encoderTerminal
          keyType: requestBody.keyType
      - text: Ask the external lock system for {count} keys for room {room}.
        slots:
          count: requestBody.noOfKeys
          room: requestBody.roomId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/floorPlans'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a property's floor plans
      effect: read
      questions:
      - Can I see a graphical layout of the floors and rooms in my hotel?
      - Where are the elevators and stairways relative to a given room?
      instructions:
      - text: Get the floor plans for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Show the floor plan containing room {room} at {hotel}.
        slots:
          room: query.room
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/fulfillmentActivityLogs'].get
  update:
    x-apievangelist-phrasing:
      intent: Review the fulfillment activity log
      effect: read
      questions:
      - What fulfillment activity has been logged at my property recently?
      - How far back can the fulfillment activity log be searched?
      instructions:
      - text: Show the fulfillment activity log at hotel {hotel} from {from} to {to}.
        slots:
          hotel: path.hotelId
          from: query.fromDate
          to: query.toDate
      - text: Search fulfillment activity at {hotel} for text {text}.
        slots:
          hotel: path.hotelId
          text: query.searchText
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/interfaces/{interfaceId}/roomStatuses'].get
  update:
    x-apievangelist-phrasing:
      intent: Get room statuses from a property interface
      effect: read
      questions:
      - What room statuses is a connected interface reporting for arriving guests?
      - Can I filter interface room statuses by floor or room class?
      instructions:
      - text: Get room interface statuses from interface {interface} at hotel {hotel}.
        slots:
          interface: path.interfaceId
          hotel: path.hotelId
      - text: Show interface {interface} room status for guest {lastName}.
        slots:
          interface: path.interfaceId
          lastName: query.lastName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/interfaces/{interfaceId}/roomStatuses'].put
  update:
    x-apievangelist-phrasing:
      intent: Change room statuses on a property interface
      effect: write
      questions:
      - Can I push an updated reservation status to a connected room interface?
      - How do I reset the interface status for a guest's room?
      instructions:
      - text: Update room statuses on interface {interface} at hotel {hotel} with {status}.
        slots:
          interface: path.interfaceId
          hotel: path.hotelId
          status: requestBody.reservationInterfaceStatus
      - text: Change the interface room status for interface {interface}.
        slots:
          interface: path.interfaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/keyInterfaces'].get
  update:
    x-apievangelist-phrasing:
      intent: Get key encoder interface configuration
      effect: read
      questions:
      - Which key encoders are configured for my door lock interface?
      - Can I look up key encoder settings for one interface id?
      instructions:
      - text: Get key encoder interface details at hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Show encoder configuration for interface {interface} at {hotel}.
        slots:
          interface: query.interfaceId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/queuedReservations'].get
  update:
    x-apievangelist-phrasing:
      intent: List queued reservations waiting for rooms
      effect: read
      questions:
      - Which arrived guests are waiting in the queue because their room isn't ready?
      - Can I search the room queue by guest name or room type?
      instructions:
      - text: List queued reservations at hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Find queued guests at {hotel} whose name matches {name}.
        slots:
          hotel: path.hotelId
          name: query.guestNameWildCard
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/queuedReservations/{reservationId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a reservation to the room queue
      effect: write
      questions:
      - How do I put an arriving guest in the queue until housekeeping readies a room?
      - Can I queue a reservation when no room of its type is available?
      instructions:
      - text: Add reservation {reservation} at hotel {hotel} to the room queue.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Queue reservation {reservation} until a room is clean.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/queuedReservations/{reservationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a reservation from the room queue
      effect: destructive
      questions:
      - How do I take a guest out of the queue once their room is assigned?
      - Can I remove one reservation from the queued rooms list?
      instructions:
      - text: Remove reservation {reservation} at hotel {hotel} from the queue.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Take {reservation} off the queued reservations list.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservationSummaries'].get
  update:
    x-apievangelist-phrasing:
      intent: Search reservation summaries for a hotel
      effect: read
      questions:
      - Can I get a quick summary list of reservations by membership number or VIP status?
      - Which reservations are staying over a given date range at my hotel?
      - What search criteria does the reservation summaries lookup support?
      instructions:
      - text: Get reservation summaries at hotel {hotel} arriving from {start} to {end}.
        slots:
          hotel: path.hotelId
          start: query.arrivalStart
          end: query.arrivalEnd
      - text: Find reservation summaries at {hotel} for company {company}.
        slots:
          hotel: path.hotelId
          company: query.companyName
      - text: Summarize reservations at {hotel} for member {member}.
        slots:
          hotel: path.hotelId
          member: query.membershipNumber
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/ai/rooms'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the last AI room assignment run
      effect: read
      questions:
      - Did the last AI room assignment run finish successfully?
      - When did automated intelligence room assignment last run at my property?
      instructions:
      - text: Get the last AI room assignment run status for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Show me how the most recent AI room assignment at {hotel} went.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/ai/rooms'].post
  update:
    x-apievangelist-phrasing:
      intent: Run AI room assignment for arrivals
      effect: write
      questions:
      - Can AI allocate rooms to all of today's incoming reservations?
      - How do I trigger automated intelligence room assignment across several hotels?
      instructions:
      - text: Run AI room assignment at hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Use AI to assign rooms for hotels {hotels}.
        slots:
          hotels: requestBody.hotelCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/autoRoomAssignments'].post
  update:
    x-apievangelist-phrasing:
      intent: Auto-assign rooms to reservations
      effect: write
      questions:
      - Can the system pick and assign rooms automatically based on criteria?
      - What criteria drive the rule-based auto room assignment?
      instructions:
      - text: Automatically assign rooms at hotel {hotel} using {criteria}.
        slots:
          hotel: path.hotelId
          criteria: requestBody.criteria
      - text: Auto-assign rooms to unassigned arrivals at {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/autoRoomAssignments'].delete
  update:
    x-apievangelist-phrasing:
      intent: Automatically unassign rooms from reservations
      effect: destructive
      questions:
      - How do I clear room assignments in bulk for a date range?
      - Can I auto-unassign rooms only on a particular floor or room type?
      instructions:
      - text: Auto-unassign rooms at hotel {hotel} from {start} to {end}.
        slots:
          hotel: path.hotelId
          start: query.startDate
          end: query.endDate
      - text: Unassign all {roomType} rooms at {hotel} automatically.
        slots:
          roomType: query.roomType
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/massAdvanceCheckIns'].post
  update:
    x-apievangelist-phrasing:
      intent: Advance check in many reservations at once
      effect: write
      questions:
      - Can I flag a whole group of today's arrivals as advance checked in?
      - What criteria select reservations for a mass advance check-in?
      instructions:
      - text: Mass advance check in reservations at hotel {hotel} matching {criteria}.
        slots:
          hotel: path.hotelId
          criteria: requestBody.criteria
      - text: Advance check in every early-arriving group reservation at {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/massCheckIns'].post
  update:
    x-apievangelist-phrasing:
      intent: Check in many reservations at once
      effect: write
      questions:
      - How do I check in a whole tour group in one step?
      - Can I mass check in reservations that match a set of criteria?
      instructions:
      - text: Check in, in one batch, every arrival at property {hotel} that fits {criteria}.
        slots:
          hotel: path.hotelId
          criteria: requestBody.criteria
      - text: Fully check in all of today's group arrivals at {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/advanceCheckIns'].post
  update:
    x-apievangelist-phrasing:
      intent: Advance check in one reservation
      effect: write
      questions:
      - Can a guest who arrived before their room is ready post charges to their folio?
      - How do I flag a single reservation as advance checked in?
      instructions:
      - text: Advance check in reservation {reservation} at hotel {hotel}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Mark {reservation} as advance checked in so the guest can charge to the room.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/advanceCheckIns'].delete
  update:
    x-apievangelist-phrasing:
      intent: Reverse an advance check-in
      effect: destructive
      questions:
      - How do I undo an advance check-in flagged by mistake?
      - Can I reverse the advance checked-in status on a reservation?
      instructions:
      - text: Reverse the advance check-in on reservation {reservation} at hotel {hotel}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Remove the advance check-in flag from {reservation}.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/checkIns'].post
  update:
    x-apievangelist-phrasing:
      intent: Check in a guest
      effect: write
      questions:
      - What status must a reservation be in before I can check the guest in?
      - Can I pick an available room as part of checking in a guest?
      instructions:
      - text: Check in reservation {reservation} at hotel {hotel}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Check in the guest on {reservation} and send notifications.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/checkIns'].delete
  update:
    x-apievangelist-phrasing:
      intent: Reverse a guest check-in
      effect: destructive
      questions:
      - How do I put a checked-in reservation back to due in status?
      - Can I unassign the room when I reverse a check-in?
      instructions:
      - text: Reverse the check-in for reservation {reservation} at hotel {hotel}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Undo check-in on {reservation} and set the room status to {status}.
        slots:
          reservation: path.reservationId
          status: query.roomStatus
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/keyOptions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get door lock key options for a reservation
      effect: read
      questions:
      - Which areas like the pool or gym can this guest's room key open?
      - What key option preferences are attached to a reservation's room and profile?
      instructions:
      - text: Get key options for reservation {reservation} at hotel {hotel}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Show the door lock access options on {reservation}.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/linked'].get
  update:
    x-apievangelist-phrasing:
      intent: List reservations linked to a reservation
      effect: read
      questions:
      - Which other reservations are linked to this booking?
      - Can I see all the rooms linked together for a family's stay?
      instructions:
      - text: Get reservations linked to {reservation} at hotel {hotel}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Show the linked reservations for {reservation}.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/priority'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a queued reservation's priority
      effect: write
      questions:
      - Can I move a VIP guest up the room-ready queue?
      - How do I set the queue priority on a waiting reservation?
      instructions:
      - text: Set queue priority {priority} on reservation {reservation} at hotel {hotel}.
        slots:
          priority: requestBody.priority
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Bump {reservation} to the top of the room queue.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/roomAssignments'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign a room to a reservation
      effect: write
      questions:
      - How do I assign a specific room to a reserved booking?
      - Can I override warnings to force a room assignment?
      instructions:
      - text: Assign a room to reservation {reservation} at hotel {hotel} using {criteria}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
          criteria: requestBody.criteria
      - text: Give reservation {reservation} room 412, overriding warnings.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/roomKeys'].get
  update:
    x-apievangelist-phrasing:
      intent: Get room key details for a reservation
      effect: read
      questions:
      - What room keys have already been cut for this reservation?
      - Can I include inactive keys when reviewing a guest's room keys?
      instructions:
      - text: Get room keys for reservation {reservation} at hotel {hotel}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: List active and inactive keys on {reservation}.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/roomKeys'].put
  update:
    x-apievangelist-phrasing:
      intent: Update existing room keys on a reservation
      effect: write
      questions:
      - Can I change key options or balances on keys already issued with multiple guest keys active?
      - How do I update room key details for guests sharing a room?
      instructions:
      - text: Update the existing room keys on reservation {reservation} at hotel {hotel} with key options {options}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
          options: requestBody.keyOptions
      - text: Change the issued keys on {reservation} for room {room}.
        slots:
          reservation: path.reservationId
          room: requestBody.roomNumber
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/roomKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Request new room keys for a reservation
      effect: write
      questions:
      - How do I cut new room keys for a reservation through the door lock interface?
      - Can I set how long a new room key stays valid?
      instructions:
      - text: Create {count} room keys for reservation {reservation} at hotel {hotel}.
        slots:
          count: requestBody.noOfKeys
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Make a new key for {reservation} valid until {end}.
        slots:
          reservation: path.reservationId
          end: requestBody.keyValidityEnd
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/roomKeys'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete room keys on a reservation
      effect: destructive
      questions:
      - How do I invalidate the room keys issued for a reservation?
      - Can I delete all keys on a booking after a guest loses them?
      instructions:
      - text: Delete room keys on reservation {reservation} at hotel {hotel}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Cancel every key issued for {reservation}.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/roomMoveHistory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a reservation's room move history
      effect: read
      questions:
      - Which rooms has this guest been moved between during their stay?
      - Can I see the history of room changes on a reservation?
      instructions:
      - text: Get room move history for reservation {reservation} at hotel {hotel}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Show all room changes on {reservation}.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/rooms'].put
  update:
    x-apievangelist-phrasing:
      intent: Unassign the room from a reservation
      effect: destructive
      questions:
      - How do I remove the assigned room from a reserved booking?
      - Can I unassign a room even if the room number is locked?
      instructions:
      - text: Remove the assigned room from reservation {reservation} at hotel {hotel}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Unassign the room on {reservation}, overriding the room number lock.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/rooms/{roomId}/roomMoves'].put
  update:
    x-apievangelist-phrasing:
      intent: Move an in-house guest to another room
      effect: write
      questions:
      - A checked-in guest wants a different room, how do I move them?
      - Can I record a room move for a guest who is already in house?
      instructions:
      - text: Move in-house reservation {reservation} at hotel {hotel} from room {room}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
          room: path.roomId
      - text: Relocate the guest on {reservation} out of room {room} using {criteria}.
        slots:
          reservation: path.reservationId
          room: path.roomId
          criteria: requestBody.criteria
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/suggestedRooms'].get
  update:
    x-apievangelist-phrasing:
      intent: Get suggested rooms for a reservation
      effect: read
      questions:
      - Which rooms does the system recommend for this reservation?
      - Can I get room suggestions that have a particular feature?
      instructions:
      - text: Get suggested rooms for reservation {reservation} at hotel {hotel}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Suggest {roomType} rooms for {reservation} with feature {feature}.
        slots:
          roomType: query.roomType
          reservation: path.reservationId
          feature: query.roomFeatureCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/textMessages/{messageType}'].put
  update:
    x-apievangelist-phrasing:
      intent: Text a queued guest that their room is ready
      effect: write
      questions:
      - Can I send a text message to a queued guest when their room is ready?
      - How do I deliver the queue rooms SMS for a reservation?
      instructions:
      - text: Send the {type} queue text message for reservation {reservation} at hotel {hotel}.
        slots:
          type: path.messageType
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Text the guest on {reservation} with message type {type}.
        slots:
          reservation: path.reservationId
          type: path.messageType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/verifyCheckIns'].get
  update:
    x-apievangelist-phrasing:
      intent: Verify a reservation can be checked in
      effect: read
      questions:
      - Is this reservation ready to be checked in, or are there blockers?
      - What checks run before a check-in is allowed?
      instructions:
      - text: Verify check-in readiness for reservation {reservation} at hotel {hotel}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Pre-check whether {reservation} passes check-in validation.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/wakeUpCalls'].get
  update:
    x-apievangelist-phrasing:
      intent: Get wake-up calls on one reservation
      effect: read
      questions:
      - What wake-up calls are set for this in-house guest?
      - Can I include completed or no-answer wake-up calls for a single reservation?
      instructions:
      - text: Get wake-up calls for reservation {reservation} at hotel {hotel}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
      - text: Show pending wake-up calls on {reservation} from {begin}.
        slots:
          reservation: path.reservationId
          begin: query.beginDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/wakeUpCalls'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a wake-up call
      effect: write
      questions:
      - How do I move an existing wake-up call to a different time?
      - Can I edit a wake-up call on an in-house reservation?
      instructions:
      - text: Update the existing wake-up call on reservation {reservation} at hotel {hotel} with {calls}.
        slots:
          reservation: path.reservationId
          hotel: path.hotelId
          calls: requestBody.calls
      - text: Reschedule the wake-up call on {reservation} to 6:30 am.
        slots:
          reservation: path.reservationId
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (44 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/overlays/oracle-hospitality-frontdeskoperations-api-phrasing-overlay.yaml