# 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 Reservation API
  version: 1.0.0
extends: openapi/oracle-hospitality-reservation-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: 179
- target: $.paths['/calls'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a call on a reservation
      effect: write
      questions:
      - 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?
      instructions:
      - text: Register this reservation call with details {call}.
        slots:
          call: requestBody.call
      - text: Log the guest's inbound call against their booking.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calls/statistics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get reservation call statistics
      effect: read
      questions:
      - What call statistics can I pull for my reservation agents?
      - Is there a limit on the date range for call statistics?
      instructions:
      - text: Show call statistics from {start} to {end}.
        slots:
          start: query.start
          end: query.end
      - text: Get call statistics for app user {user} over the last 30 days.
        slots:
          user: query.appUserName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalSystems/{extSystemCode}/reservations'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up reservations by external system references
      effect: read
      questions:
      - 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?
      instructions:
      - text: List reservations from external system {system} with external references {refs}.
        slots:
          system: path.extSystemCode
          refs: query.externalReferenceList
      - text: Look up external system {system} bookings for references {refs} arriving from {from}.
        slots:
          system: path.extSystemCode
          refs: query.externalReferenceList
          from: query.arrivalStartDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalSystems/{extSystemCode}/reservations/searches'].post
  update:
    x-apievangelist-phrasing:
      intent: Search external-system reservations via request body
      effect: read
      questions:
      - 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?
      instructions:
      - text: Run a body-based reservation search for external system {system} with references {refs}.
        slots:
          system: path.extSystemCode
          refs: requestBody.externalReferenceList
      - text: Submit a search request for external system {system} references {refs} for guest surname {surname}.
        slots:
          system: path.extSystemCode
          refs: requestBody.externalReferenceList
          surname: requestBody.surname
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/awardUpgrades'].get
  update:
    x-apievangelist-phrasing:
      intent: Get award upgrades available at a property
      effect: read
      questions:
      - Which loyalty award upgrades can a member redeem at this hotel?
      - Can I check award upgrades for a membership card number?
      instructions:
      - text: Show award upgrades at hotel {hotelId} for membership card {card}.
        slots:
          hotelId: path.hotelId
          card: query.membershipCardNo
      - text: Get award upgrades at hotel {hotelId} for room type {roomType}.
        slots:
          hotelId: path.hotelId
          roomType: query.roomType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/awards'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch certificates and awards on a reservation
      effect: read
      questions:
      - What certificates and awards are attached to a guest's reservation?
      - Can I see which award certificates a booking is using?
      instructions:
      - text: Fetch awards and certificates for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: query.reservationId
          hotelId: path.hotelId
      - text: List award certificates tied to bookings at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/blocks/{blockId}/reservations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a reservation inside a group block
      effect: write
      questions:
      - 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?
      instructions:
      - text: Create a reservation in block {blockId} at hotel {hotelId}.
        slots:
          blockId: path.blockId
          hotelId: path.hotelId
      - text: Book {reservations} into group block {blockId} at hotel {hotelId}.
        slots:
          reservations: requestBody.reservations
          blockId: path.blockId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/cancellationPolicies'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a property's cancellation policy
      effect: write
      questions:
      - Can I edit a cancellation policy that's already configured for my hotel?
      - What do I send to change the property cancellation policy?
      instructions:
      - text: Update the cancellation policy at hotel {hotelId} to {policy}.
        slots:
          hotelId: path.hotelId
          policy: requestBody.policy
      - text: Change the existing cancellation policy configured for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/confirmationLetters'].get
  update:
    x-apievangelist-phrasing:
      intent: List reservations needing confirmation letters
      effect: read
      questions:
      - Which reservations still need a confirmation letter sent?
      - Can I filter pending confirmation letters by arrival date?
      - What's the maximum date range for the confirmation letter list?
      instructions:
      - text: List pending confirmation letters at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Show reservations at hotel {hotelId} arriving from {from} to {to} that need confirmation letters.
        slots:
          hotelId: path.hotelId
          from: query.arrivalStartDate
          to: query.arrivalEndDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/confirmationLetters'].post
  update:
    x-apievangelist-phrasing:
      intent: Create confirmation letters for reservations
      effect: write
      questions:
      - How do I generate a confirmation letter for a guest's booking?
      - Can I create confirmation letters for a specific reservation?
      instructions:
      - text: Create a confirmation letter for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: requestBody.reservationId
          hotelId: path.hotelId
      - text: Generate confirmation letters {letters} at hotel {hotelId}.
        slots:
          letters: requestBody.confLetters
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/depositPolicies'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a property's deposit policy
      effect: write
      questions:
      - Can I modify the deposit policy my hotel already has?
      - What's needed to change an existing property deposit rule?
      instructions:
      - text: Update the deposit policy at hotel {hotelId} to {policy}.
        slots:
          hotelId: path.hotelId
          policy: requestBody.policy
      - text: Change the existing deposit policy configured for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/linkedReservations/{reservationExternalId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Link reservations using an external reservation ID
      effect: write
      questions:
      - 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?
      instructions:
      - text: Link reservations {ids} to external reservation {extId} from system {system} at hotel {hotelId}.
        slots:
          ids: requestBody.reservationIdList
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      - text: Using external system {system} ID {extId}, link other bookings at hotel {hotelId}.
        slots:
          system: path.externalSystemCode
          extId: path.reservationExternalId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/linkedReservations/{reservationExternalId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink a reservation by its external ID
      effect: destructive
      questions:
      - Can I unlink a reservation identified by my external system's ID?
      - What happens when I remove reservation links using an external reference?
      instructions:
      - text: Unlink external reservation {extId} from system {system} at hotel {hotelId}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      - text: Remove the reservation links on external booking {extId} ({system}) at hotel {hotelId}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a reservation by its external system ID
      effect: read
      questions:
      - 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?
      instructions:
      - text: Get reservation {extId} from external system {system} at hotel {hotelId}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      - text: Show the booking with external ID {extId} ({system}) at hotel {hotelId}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a reservation by its external system ID
      effect: write
      questions:
      - 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?
      instructions:
      - text: Update external reservation {extId} from {system} at hotel {hotelId} with {reservations}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
          reservations: requestBody.reservations
      - text: Add a comment to the booking with external ID {extId} ({system}) at hotel {hotelId}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/addOnReservationPackagesByExtId'].put
  update:
    x-apievangelist-phrasing:
      intent: Update add-on packages via external reservation ID
      effect: write
      questions:
      - 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?
      instructions:
      - text: Set add-on packages {packages} on external reservation {extId} from {system} at hotel {hotelId}.
        slots:
          packages: requestBody.reservationPackages
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      - text: Update sell-separate packages on leg {leg} of external booking {extId} ({system}) at hotel {hotelId}.
        slots:
          leg: query.legNumber
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/cancellations'].put
  update:
    x-apievangelist-phrasing:
      intent: Reinstate a cancelled reservation by external ID
      effect: write
      questions:
      - 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?
      instructions:
      - text: Reinstate cancelled external reservation {extId} from {system} at hotel {hotelId}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      - text: Restore external booking {extId} ({system}) at hotel {hotelId}, overriding inventory {override}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
          override: requestBody.overrideInventory
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/cancellations'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a reservation by its external ID
      effect: destructive
      questions:
      - 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?
      instructions:
      - text: Cancel external reservation {extId} from {system} at hotel {hotelId}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      - text: Cancel external booking {extId} ({system}) at hotel {hotelId} with reason {reason}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/routingInstructions'].put
  update:
    x-apievangelist-phrasing:
      intent: Change routing instructions via external reservation ID
      effect: write
      questions:
      - 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?
      instructions:
      - text: Change routing instructions on external reservation {extId} ({system}) at hotel {hotelId} to {criteria}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
          criteria: requestBody.criteria
      - text: Update the existing charge routing for external booking {extId} from {system} at hotel {hotelId}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/routingInstructions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create routing instructions via external reservation ID
      effect: write
      questions:
      - 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?
      instructions:
      - text: Create routing instructions {criteria} on external reservation {extId} ({system}) at hotel {hotelId}.
        slots:
          criteria: requestBody.criteria
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      - text: Add new billing routing to external booking {extId} from {system} at hotel {hotelId}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/separatedShare'].put
  update:
    x-apievangelist-phrasing:
      intent: Separate a share by external ID with external daily rates
      effect: write
      questions:
      - 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?
      instructions:
      - text: Separate share external reservation {extId} ({system}) at hotel {hotelId} using external daily rates {criteria}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
          criteria: requestBody.criteria
      - text: Split external share {extId} from {system} at hotel {hotelId}, overriding the inventory check {override}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
          override: query.overrideInventoryCheck
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/shares'].get
  update:
    x-apievangelist-phrasing:
      intent: Get share reservations by external reservation ID
      effect: read
      questions:
      - Which share reservations exist on a booking my external system references?
      - Can I see who is sharing a room using the external reservation ID?
      instructions:
      - text: List share reservations on external reservation {extId} ({system}) at hotel {hotelId}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      - text: Show sharers for external booking {extId} from {system} at hotel {hotelId}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/shares'].post
  update:
    x-apievangelist-phrasing:
      intent: Combine share reservations by external ID
      effect: write
      questions:
      - 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?
      instructions:
      - text: Combine share reservations {criteria} with external reservation {extId} ({system}) at hotel {hotelId}.
        slots:
          criteria: requestBody.criteria
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      - text: Share the room on external booking {extId} from {system} at hotel {hotelId} with another reservation.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/externalSystems/{externalSystemCode}/reservations/{reservationExternalId}/shares'].delete
  update:
    x-apievangelist-phrasing:
      intent: Separate share reservations by external ID
      effect: destructive
      questions:
      - 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?
      instructions:
      - text: Separate the share reservations on external reservation {extId} ({system}) at hotel {hotelId}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
      - text: Break the share on external booking {extId} from {system} at hotel {hotelId} and return shares {returnShares}.
        slots:
          extId: path.reservationExternalId
          system: path.externalSystemCode
          hotelId: path.hotelId
          returnShares: query.returnShareReservations
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/fetchExternalSystemDeliveryHistory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get external system delivery history
      effect: read
      questions:
      - 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?
      instructions:
      - text: Show external system delivery history for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: query.reservationId
          hotelId: path.hotelId
      - text: Get the external delivery log at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/guestMessages'].get
  update:
    x-apievangelist-phrasing:
      intent: Search guest messages across a hotel
      effect: read
      questions:
      - Which guest messages at my hotel are still undelivered?
      - Can I find guest messages by room number or confirmation number?
      - What's the most guest messages I can fetch per page?
      instructions:
      - text: List undelivered guest messages at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Find guest messages at hotel {hotelId} for room {room}.
        slots:
          hotelId: path.hotelId
          room: query.room
      - text: Show guest messages for confirmation {confirmationNo} at hotel {hotelId}.
        slots:
          confirmationNo: query.confirmationNo
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/locks/{lockHandle}'].put
  update:
    x-apievangelist-phrasing:
      intent: Extend a reservation lock
      effect: write
      questions:
      - 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?
      instructions:
      - text: Extend reservation lock {lockHandle} at hotel {hotelId} by {extra}.
        slots:
          lockHandle: path.lockHandle
          hotelId: path.hotelId
          extra: requestBody.additionalTimeToLive
      - text: Keep lock {lockHandle} at hotel {hotelId} alive longer.
        slots:
          lockHandle: path.lockHandle
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/locks/{lockHandle}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Release a reservation lock
      effect: destructive
      questions:
      - 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?
      instructions:
      - text: Release reservation lock {lockHandle} at hotel {hotelId}.
        slots:
          lockHandle: path.lockHandle
          hotelId: path.hotelId
      - text: Free up lock handle {lockHandle} so the booking at hotel {hotelId} is editable again.
        slots:
          lockHandle: path.lockHandle
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/preArrivalMembersReservations'].get
  update:
    x-apievangelist-phrasing:
      intent: Get upcoming reservations for loyalty members
      effect: read
      questions:
      - Which loyalty members are arriving at my hotel soon?
      - Can I list pre-arrival reservations by membership type?
      instructions:
      - text: List pre-arrival member reservations at hotel {hotelId} from {start} to {end}.
        slots:
          hotelId: path.hotelId
          start: query.start
          end: query.end
      - text: Show upcoming arrivals at hotel {hotelId} for membership type {type}.
        slots:
          hotelId: path.hotelId
          type: query.membershipType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/preConfiguredRoutingInstructions'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up pre-configured routing instructions
      effect: read
      questions:
      - What default billing routing is set up for a company or rate code?
      - Can I see pre-configured routing for a travel agent profile?
      instructions:
      - text: Get pre-configured routing instructions at hotel {hotelId} for rate code {rateCode}.
        slots:
          hotelId: path.hotelId
          rateCode: query.rateCode
      - text: Look up preset routing at hotel {hotelId} for company {company}.
        slots:
          hotelId: path.hotelId
          company: query.companyName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/preConfiguredRoutingInstructions/searches'].post
  update:
    x-apievangelist-phrasing:
      intent: Search pre-configured routing via request body
      effect: read
      questions:
      - 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?
      instructions:
      - text: Run a body search for pre-configured routing at hotel {hotelId} for group {group}.
        slots:
          hotelId: path.hotelId
          group: requestBody.groupName
      - text: Submit a routing preset search at hotel {hotelId} for guest {guest}.
        slots:
          hotelId: path.hotelId
          guest: requestBody.guestName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/profiles/{profileIdtoShare}/share'].get
  update:
    x-apievangelist-phrasing:
      intent: Find reservations a guest profile can share
      effect: read
      questions:
      - Which existing reservations could this guest profile join as a sharer?
      - Can I find shareable bookings for a profile by surname?
      instructions:
      - text: Find reservations profile {profileId} can share at hotel {hotelId}.
        slots:
          profileId: path.profileIdtoShare
          hotelId: path.hotelId
      - text: Show shareable bookings at hotel {hotelId} for profile {profileId} with surname {surname}.
        slots:
          hotelId: path.hotelId
          profileId: path.profileIdtoShare
          surname: query.surname
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/rateInfoValidation'].put
  update:
    x-apievangelist-phrasing:
      intent: Validate rate plan information for a stay
      effect: read
      questions:
      - Is the rate plan I picked valid for this reservation's dates?
      - Can I check rate information before committing a booking?
      instructions:
      - text: Validate rate information {criteria} at hotel {hotelId}.
        slots:
          criteria: requestBody.criteria
          hotelId: path.hotelId
      - text: Check that the chosen rate plan works for this booking at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations'].get
  update:
    x-apievangelist-phrasing:
      intent: Find reservations at one hotel
      effect: read
      questions:
      - 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?
      - Which reservations at my property have an open balance?
      instructions:
      - text: List reservations at hotel {hotelId} arriving between {from} and {to}.
        slots:
          hotelId: path.hotelId
          from: query.arrivalStartDate
          to: query.arrivalEndDate
      - text: Find the booking at hotel {hotelId} for guest surname {surname}.
        slots:
          hotelId: path.hotelId
          surname: query.surname
      - text: Look up confirmation number {confirmation} at hotel {hotelId}.
        slots:
          confirmation: query.confirmationNumberList
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new hotel reservation
      effect: write
      questions:
      - How do I book a new room reservation at a hotel?
      - What do I need to send to create a reservation after checking availability?
      instructions:
      - text: Create a reservation at hotel {hotelId} for {reservations}.
        slots:
          hotelId: path.hotelId
          reservations: requestBody.reservations
      - text: Book a new stay at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/activityLog'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch a reservation activity log
      effect: read
      questions:
      - Who changed this reservation and when?
      - Can I filter the reservation activity log by activity type and date?
      - How far back can one activity log request cover?
      instructions:
      - text: Show the reservation activity log at hotel {hotelId} from {from} to {to}.
        slots:
          hotelId: path.hotelId
          from: query.fromDate
          to: query.toDate
      - text: Get activity log entries at hotel {hotelId} of type {type}.
        slots:
          hotelId: path.hotelId
          type: query.activityType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/alerts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or update alerts on many reservations
      effect: write
      questions:
      - Can I add the same alert to many reservations at once?
      - Is there a bulk way to create reservation alerts for front desk staff?
      instructions:
      - text: Create bulk reservation alerts {reservations} at hotel {hotelId}.
        slots:
          reservations: requestBody.reservations
          hotelId: path.hotelId
      - text: Add a check-in alert to several bookings at hotel {hotelId} in one go.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/cancellations'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel multiple reservations at once
      effect: destructive
      questions:
      - Can I cancel several reservations in a single request?
      - How do I bulk-cancel bookings at my hotel?
      instructions:
      - text: Cancel reservations {cancellations} at hotel {hotelId}.
        slots:
          cancellations: requestBody.cancelReservations
          hotelId: path.hotelId
      - text: Bulk cancel a batch of bookings at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/linkedReservations/{reservationId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update common details across linked reservations
      effect: write
      questions:
      - 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?
      instructions:
      - text: Update common details {details} for all reservations linked to {reservationId} at hotel {hotelId}.
        slots:
          details: requestBody.linkedReservationsCommonDetails
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Apply shared changes across the linked group of reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/linkedReservations/{reservationId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Link reservations to a reservation at a hotel
      effect: write
      questions:
      - 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?
      instructions:
      - text: Link reservations {ids} to reservation {reservationId} at hotel {hotelId}.
        slots:
          ids: requestBody.reservationIdList
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Group other bookings under reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/linkedReservations/{reservationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink a reservation at a hotel
      effect: destructive
      questions:
      - 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?
      instructions:
      - text: Unlink reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove the link on booking {reservationId} at hotel {hotelId} from its associated reservation.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/packageCategoryReservations'].get
  update:
    x-apievangelist-phrasing:
      intent: Get reservations consuming a package on a date
      effect: read
      questions:
      - Which guests have a breakfast package to consume on a given date?
      - Can I filter package consumption reservations by package category?
      instructions:
      - text: List reservations at hotel {hotelId} consuming packages on {date}.
        slots:
          hotelId: path.hotelId
          date: query.date
      - text: Show bookings at hotel {hotelId} with package {package} on {date}.
        slots:
          hotelId: path.hotelId
          package: query.packageCode
          date: query.date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/policies'].put
  update:
    x-apievangelist-phrasing:
      intent: Find deposit and cancellation policies for criteria
      effect: read
      questions:
      - 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?
      instructions:
      - text: Get applicable deposit and cancellation policies at hotel {hotelId} for arrival {arrival} to {departure}.
        slots:
          hotelId: path.hotelId
          arrival: requestBody.arrivalDate
          departure: requestBody.departureDate
      - text: Check policies at hotel {hotelId} for guarantee code {guarantee} with an estimated amount.
        slots:
          hotelId: path.hotelId
          guarantee: requestBody.guaranteeCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/rateInfo'].get
  update:
    x-apievangelist-phrasing:
      intent: Get rate plan information for a stay
      effect: read
      questions:
      - What rates apply to a stay for two adults and a child?
      - Can I look up rate plan details by room type and dates?
      - What's the maximum date span for a rate information lookup?
      instructions:
      - text: Get rate information at hotel {hotelId} for rate plan {ratePlan} from {start} to {end}.
        slots:
          hotelId: path.hotelId
          ratePlan: query.ratePlanCode
          start: query.criteriaStartDate
          end: query.criteriaEndDate
      - text: Show rate details at hotel {hotelId} for room type {roomType} with {adults} adults.
        slots:
          hotelId: path.hotelId
          roomType: query.roomType
          adults: query.adults
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/rateInfo/searches'].post
  update:
    x-apievangelist-phrasing:
      intent: Search rate plan information via request body
      effect: read
      questions:
      - 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?
      instructions:
      - text: Run a body rate information search at hotel {hotelId} for rate plan {ratePlan}.
        slots:
          hotelId: path.hotelId
          ratePlan: requestBody.ratePlanCode
      - text: Submit a rate search at hotel {hotelId} for block {blockId} in currency {currency}.
        slots:
          hotelId: path.hotelId
          blockId: requestBody.blockId
          currency: requestBody.currencyCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/reservationCancellations'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel reservations including multiple sharers
      effect: destructive
      questions:
      - Can I cancel all the share reservations in a room with one request?
      - How do I cancel a shared booking and its sharers together?
      instructions:
      - text: Cancel share reservations {reservations} at hotel {hotelId} in one request.
        slots:
          reservations: requestBody.reservations
          hotelId: path.hotelId
      - text: Cancel every sharer on the room at hotel {hotelId} with reason {reason}.
        slots:
          hotelId: path.hotelId
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/searches'].post
  update:
    x-apievangelist-phrasing:
      intent: Search one hotel's reservations via request body
      effect: read
      questions:
      - 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?
      instructions:
      - text: Run a body search of hotel {hotelId} reservations for surname {surname}.
        slots:
          hotelId: path.hotelId
          surname: requestBody.surname
      - text: Submit a reservation search at hotel {hotelId} for arrivals from {from} to {to}.
        slots:
          hotelId: path.hotelId
          from: requestBody.arrivalStartDate
          to: requestBody.arrivalEndDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/statistics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get distribution reservation statistics
      effect: read
      questions:
      - How many reservations came through each distribution channel?
      - Can I get channel booking statistics for a date range?
      instructions:
      - text: Show distribution reservation statistics at hotel {hotelId} from {start} to {end}.
        slots:
          hotelId: path.hotelId
          start: query.startDate
          end: query.endDate
      - text: Get the distribution summary at hotel {hotelId} for channel {channel}.
        slots:
          hotelId: path.hotelId
          channel: query.channelCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a brief summary list of reservations
      effect: read
      questions:
      - Can I get a lightweight summary of reservations instead of full records?
      - Which pre-registered reservations arrive today, in summary form?
      instructions:
      - text: Get brief reservation summaries at hotel {hotelId} arriving on {arrival}.
        slots:
          hotelId: path.hotelId
          arrival: query.arrivalDate
      - text: Show a short summary for confirmation {confirmation} at hotel {hotelId}.
        slots:
          confirmation: query.confirmationNumber
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/summary/searches'].post
  update:
    x-apievangelist-phrasing:
      intent: Search brief reservation summaries via request body
      effect: read
      questions:
      - Is there a POST search that returns only brief reservation summaries?
      - Can I send summary search criteria like last name in a request body?
      instructions:
      - text: Run a body summary search at hotel {hotelId} for last name {lastName}.
        slots:
          hotelId: path.hotelId
          lastName: requestBody.lastName
      - text: Submit a brief-summary search at hotel {hotelId} for departures on {departure}.
        slots:
          hotelId: path.hotelId
          departure: requestBody.departureDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/validations'].put
  update:
    x-apievangelist-phrasing:
      intent: Validate a reservation before creating or changing it
      effect: read
      questions:
      - Can I check whether a new or modified reservation would be accepted before saving it?
      - What gets validated before I apply reservation changes?
      instructions:
      - text: Validate reservation {reservation} at hotel {hotelId} before saving.
        slots:
          reservation: requestBody.reservation
          hotelId: path.hotelId
      - text: Dry-run check my pending booking changes at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationIdtoShare}/share'].get
  update:
    x-apievangelist-phrasing:
      intent: Find reservations that can share with a booking
      effect: read
      questions:
      - Which reservations could share a room with this existing booking?
      - Can I narrow shareable reservations by confirmation number?
      instructions:
      - text: Find reservations that can share with reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationIdtoShare
          hotelId: path.hotelId
      - text: List share candidates for booking {reservationId} at hotel {hotelId} with surname {surname}.
        slots:
          reservationId: path.reservationIdtoShare
          hotelId: path.hotelId
          surname: query.surname
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a reservation by its internal ID
      effect: read
      questions:
      - 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?
      instructions:
      - text: Get reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Open booking {reservationId} at hotel {hotelId} and include {fetch}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          fetch: query.fetchInstructions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a reservation by its internal ID
      effect: write
      questions:
      - How do I change the number of guests on an existing reservation?
      - Can I add comments to a booking after it's been made?
      instructions:
      - text: Update reservation {reservationId} at hotel {hotelId} with {reservations}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          reservations: requestBody.reservations
      - text: Change the guest count on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an on-hold reservation at a hotel
      effect: destructive
      questions:
      - 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?
      instructions:
      - text: Delete on-hold reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Discard the in-session booking {reservationId} held at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/addOnReservationPackages'].put
  update:
    x-apievangelist-phrasing:
      intent: Update add-on packages on a reservation
      effect: write
      questions:
      - How do I update the sell-separate add-on packages on a reservation?
      - Can I override inventory item availability when changing add-on packages?
      instructions:
      - text: Set add-on packages {packages} on reservation {reservationId} at hotel {hotelId}.
        slots:
          packages: requestBody.reservationPackages
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Replace the sell-separate add-ons on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/alerts'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch alert notices for a reservation
      effect: read
      questions:
      - What alerts pop up for staff when handling this reservation?
      - Can I include global alerts and welcome offers in a reservation's alert notices?
      instructions:
      - text: Show alert notices for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Get check-in area alerts {area} for booking {reservationId} at hotel {hotelId}.
        slots:
          area: query.alertArea
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/attachments'].get
  update:
    x-apievangelist-phrasing:
      intent: Get attachments on a reservation
      effect: read
      questions:
      - What files are attached to a guest's reservation?
      - Can I retrieve the web registration card attached to a booking?
      instructions:
      - text: List attachments on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Get the attached file named {fileName} on booking {reservationId} at hotel {hotelId}.
        slots:
          fileName: query.attachedFileName
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/attachments/{attachmentId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an attachment from a reservation
      effect: destructive
      questions:
      - How do I remove a file attached to a reservation?
      - Can I delete a single attachment from a booking by its ID?
      instructions:
      - text: Delete attachment {attachmentId} from reservation {reservationId} at hotel {hotelId}.
        slots:
          attachmentId: path.attachmentId
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove attached file {attachmentId} on booking {reservationId} at hotel {hotelId}.
        slots:
          attachmentId: path.attachmentId
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/breakshares/action/validate'].put
  update:
    x-apievangelist-phrasing:
      intent: Validate before breaking a share reservation
      effect: read
      questions:
      - Will breaking this share reservation run into any problems?
      - Can I pre-check a share separation before I do it?
      instructions:
      - text: Validate breaking the share on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Pre-check whether booking {reservationId} at hotel {hotelId} can leave its share.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/calls'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a reservation's call history
      effect: read
      questions:
      - What calls have been logged against this reservation?
      - Can I see the phone call history for a guest's booking?
      instructions:
      - text: Show the call history for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: List logged calls on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/cancellationHistory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a reservation's cancellation history
      effect: read
      questions:
      - When was this reservation cancelled and what were the stay details?
      - Can I filter cancellation history by room type or rate plan?
      instructions:
      - text: Get cancellation history for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show cancellation records on booking {reservationId} at hotel {hotelId} for rate plan {ratePlan}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          ratePlan: query.ratePlanCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/cancellationPolicies'].put
  update:
    x-apievangelist-phrasing:
      intent: Compute cancellation policies for a reservation
      effect: read
      questions:
      - What cancellation penalty would apply to this reservation right now?
      - Can I calculate the cancellation policies on an existing booking?
      instructions:
      - text: Compute cancellation policies for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Calculate the cancellation terms for booking {reservationId} at hotel {hotelId} using {criteria}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          criteria: requestBody.criteria
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/cancellationPolicies'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a cancellation policy on a reservation
      effect: write
      questions:
      - How do I add a cancellation policy to a specific reservation?
      - Can I set a custom cancellation rule for one booking?
      instructions:
      - text: Create cancellation policy {policy} on reservation {reservationId} at hotel {hotelId}.
        slots:
          policy: requestBody.policy
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Add a new cancellation rule to booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/cancellationPolicies'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a cancellation policy from a reservation
      effect: destructive
      questions:
      - How do I remove a cancellation policy from a reservation?
      - Which policy ID do I need to delete a cancellation rule?
      instructions:
      - text: Delete cancellation policy {policyId} from reservation {reservationId} at hotel {hotelId}.
        slots:
          policyId: query.policyId
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove cancellation rule {policyId} on booking {reservationId} at hotel {hotelId}.
        slots:
          policyId: query.policyId
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/cancellations'].put
  update:
    x-apievangelist-phrasing:
      intent: Reinstate a cancelled reservation
      effect: write
      questions:
      - How do I reinstate a reservation a guest cancelled by mistake?
      - Can I restore a cancelled booking and override rates?
      instructions:
      - text: Reinstate cancelled reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Restore booking {reservationId} at hotel {hotelId}, overriding rates {overrideRates}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          overrideRates: requestBody.overrideRates
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/cancellations'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a reservation
      effect: destructive
      questions:
      - How do I cancel a guest's reservation?
      - Will I receive a cancellation number when I cancel a booking?
      - Can I only verify a cancellation without actually cancelling?
      instructions:
      - text: Cancel reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: 'Guest wants out: cancel OPERA booking {reservationId} at hotel {hotelId}, logging reason {reason}.'
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/certificates'].post
  update:
    x-apievangelist-phrasing:
      intent: Attach an award certificate to a reservation
      effect: write
      questions:
      - How do I apply a loyalty award certificate to a booking?
      - Can I attach a free-night certificate to a reservation?
      instructions:
      - text: Attach certificate {awards} to reservation {reservationId} at hotel {hotelId}.
        slots:
          awards: requestBody.awards
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Apply an award certificate to booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/certificates'].delete
  update:
    x-apievangelist-phrasing:
      intent: Detach a certificate from a reservation
      effect: destructive
      questions:
      - 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?
      instructions:
      - text: Detach the certificate from reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove the award certificate on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/combineshares/action/validate'].put
  update:
    x-apievangelist-phrasing:
      intent: Validate before combining share reservations
      effect: read
      questions:
      - Can two reservations be combined into a share without errors?
      - Is there a pre-check before I combine bookings as sharers?
      instructions:
      - text: Validate combining reservation {reservationId} at hotel {hotelId} with {shareTo}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          shareTo: requestBody.shareToReservationId
      - text: Pre-check a share combine for booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/consumedPackageQuantity'].put
  update:
    x-apievangelist-phrasing:
      intent: Update consumed package quantities
      effect: write
      questions:
      - 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?
      instructions:
      - text: Update consumed package quantity {info} on reservation {reservationId} at hotel {hotelId}.
        slots:
          info: requestBody.packageQuantityInfo
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Mark package usage as consumed for booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/copy'].post
  update:
    x-apievangelist-phrasing:
      intent: Copy a reservation
      effect: write
      questions:
      - Can I duplicate an existing reservation for a returning guest?
      - How do I make a copy of a booking with the same details?
      instructions:
      - text: Copy reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Duplicate booking {reservationId} at hotel {hotelId} using {criteria}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          criteria: requestBody.criteria
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/dailyRates/action/validate'].put
  update:
    x-apievangelist-phrasing:
      intent: Validate a daily rate detail change
      effect: read
      questions:
      - Will changing a night's rate on this reservation be allowed?
      - Can I validate daily rate edits before applying them?
      instructions:
      - text: Validate the daily rate change {detail} on reservation {reservationId} at hotel {hotelId}.
        slots:
          detail: requestBody.newDetail
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Pre-check nightly rate edits for booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/depositPolicies'].put
  update:
    x-apievangelist-phrasing:
      intent: Compute deposit policies for a reservation
      effect: read
      questions:
      - How much deposit is due on this reservation under its policies?
      - Can I calculate the deposit requirements for an existing booking?
      instructions:
      - text: Compute deposit policies for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Calculate deposit terms for booking {reservationId} at hotel {hotelId} using {criteria}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          criteria: requestBody.criteria
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/depositPolicies'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a deposit policy on a reservation
      effect: write
      questions:
      - How do I add a deposit requirement to a reservation?
      - Can I create a deposit policy for a specific booking?
      instructions:
      - text: Create deposit policy {policy} on reservation {reservationId} at hotel {hotelId}.
        slots:
          policy: requestBody.policy
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Add a deposit rule to booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/depositPolicies'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a deposit policy from a reservation
      effect: destructive
      questions:
      - How do I remove a deposit policy from a reservation?
      - What ID do I pass to delete a deposit rule?
      instructions:
      - text: Delete deposit policy {policyId} from reservation {reservationId} at hotel {hotelId}.
        slots:
          policyId: query.policyId
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove deposit rule {policyId} on booking {reservationId} at hotel {hotelId}.
        slots:
          policyId: query.policyId
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/eCoupons'].get
  update:
    x-apievangelist-phrasing:
      intent: Get e-coupons on a reservation
      effect: read
      questions:
      - What e-coupons does this guest have on their reservation?
      - Can I page through a booking's electronic coupons?
      instructions:
      - text: List e-coupons on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show electronic coupons for booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/eCoupons'].put
  update:
    x-apievangelist-phrasing:
      intent: Change e-coupons on a reservation
      effect: write
      questions:
      - How do I modify an existing e-coupon on a reservation?
      - Can I update the electronic coupons already issued to a booking?
      instructions:
      - text: Update e-coupons {coupons} on reservation {reservationId} at hotel {hotelId}.
        slots:
          coupons: requestBody.eCoupons
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Change the existing electronic coupons on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/eCoupons'].post
  update:
    x-apievangelist-phrasing:
      intent: Create e-coupons on a reservation
      effect: write
      questions:
      - How do I issue a new e-coupon to a guest's reservation?
      - Can I add electronic coupons to a booking?
      instructions:
      - text: Create e-coupons {coupons} on reservation {reservationId} at hotel {hotelId}.
        slots:
          coupons: requestBody.eCoupons
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Issue a new electronic coupon for booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/eCoupons'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete e-coupons from a reservation
      effect: destructive
      questions:
      - How do I remove an e-coupon from a reservation?
      - Can I delete one specific electronic coupon by ID?
      instructions:
      - text: Delete e-coupon {couponId} from reservation {reservationId} at hotel {hotelId}.
        slots:
          couponId: query.eCouponId
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove the electronic coupons on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/flexFieldCode/{flexFieldCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a flex field value from a reservation
      effect: destructive
      questions:
      - How do I clear a custom flex field value on a reservation?
      - Can I remove one flex field by its code from a booking?
      instructions:
      - text: Delete flex field {code} from reservation {reservationId} at hotel {hotelId}.
        slots:
          code: path.flexFieldCode
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Clear the custom field value {code} on booking {reservationId} at hotel {hotelId}.
        slots:
          code: path.flexFieldCode
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/flexFieldValues'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch flex field values on a reservation
      effect: read
      questions:
      - What custom flex field values are stored on this reservation?
      - Can I look up a reservation's flex field by code?
      instructions:
      - text: Get flex field values on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show the value of flex field {code} on booking {reservationId} at hotel {hotelId}.
        slots:
          code: query.flexFieldCode
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/flexFieldValues'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a flex field value on a reservation
      effect: write
      questions:
      - How do I change a custom flex field value already on a reservation?
      - Can I edit an existing flex field on a booking?
      instructions:
      - text: Update flex field value {info} on reservation {reservationId} at hotel {hotelId}.
        slots:
          info: requestBody.flexFieldValueInfo
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Change the existing custom field on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/flexFieldValues'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a flex field value on a reservation
      effect: write
      questions:
      - 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?
      instructions:
      - text: Create flex field value {info} on reservation {reservationId} at hotel {hotelId}.
        slots:
          info: requestBody.flexFieldValueInfo
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Add a new custom field to booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/guestLocators'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch guest locators on a reservation
      effect: read
      questions:
      - Where did the guest say they'd be if someone calls for them?
      - Can I see the guest locator notes on a reservation?
      instructions:
      - text: Get guest locators for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show where the guest on booking {reservationId} at hotel {hotelId} can be found.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/guestLocators'].post
  update:
    x-apievangelist-phrasing:
      intent: Create guest locators for reservations
      effect: write
      questions:
      - How do I record that a guest is at the spa until 3pm?
      - Can I add a guest locator to several reservations at once?
      instructions:
      - text: Create guest locator {locators} on reservation {reservationId} at hotel {hotelId}.
        slots:
          locators: requestBody.reservationLocators
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Add a new whereabouts note for the guest on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/guestLocators/{locatorId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a guest locator on a reservation
      effect: write
      questions:
      - Can I edit a guest locator entry that's already on a reservation?
      - How do I update where a guest said they'd be?
      instructions:
      - text: Change guest locator {locatorId} on reservation {reservationId} at hotel {hotelId} to {locators}.
        slots:
          locatorId: path.locatorId
          reservationId: path.reservationId
          hotelId: path.hotelId
          locators: requestBody.reservationLocators
      - text: Update locator {locatorId} for booking {reservationId} at hotel {hotelId}.
        slots:
          locatorId: path.locatorId
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/guestLocators/{locatorId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a guest locator from a reservation
      effect: destructive
      questions:
      - How do I delete an outdated guest locator?
      - Can I remove one locator entry from a booking?
      instructions:
      - text: Delete guest locator {locatorId} from reservation {reservationId} at hotel {hotelId}.
        slots:
          locatorId: path.locatorId
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove locator {locatorId} on booking {reservationId} at hotel {hotelId}.
        slots:
          locatorId: path.locatorId
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/guestMessages'].put
  update:
    x-apievangelist-phrasing:
      intent: Change all guest messages on a reservation
      effect: write
      questions:
      - 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?
      instructions:
      - text: Update guest messages {messages} on reservation {reservationId} at hotel {hotelId}.
        slots:
          messages: requestBody.guestMessages
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Change the message list for booking {reservationId} at hotel {hotelId} in bulk.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/guestMessages'].post
  update:
    x-apievangelist-phrasing:
      intent: Leave a guest message on a reservation
      effect: write
      questions:
      - 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?
      instructions:
      - text: Leave guest message {messages} on reservation {reservationId} at hotel {hotelId}.
        slots:
          messages: requestBody.guestMessages
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Create a new message for the guest on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/guestMessages/{guestMessageId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change one guest message on a reservation
      effect: write
      questions:
      - Can I edit the text of a single guest message I already left?
      - How do I update one specific guest message by its ID?
      instructions:
      - text: Change guest message {messageId} on reservation {reservationId} at hotel {hotelId}.
        slots:
          messageId: path.guestMessageId
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Edit message {messageId} for booking {reservationId} at hotel {hotelId} to {messages}.
        slots:
          messageId: path.guestMessageId
          reservationId: path.reservationId
          hotelId: path.hotelId
          messages: requestBody.guestMessages
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/guestMessages/{guestMessageId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a guest message from a reservation
      effect: destructive
      questions:
      - How do I delete a guest message that's no longer relevant?
      - Can I remove a single message from a guest's reservation?
      instructions:
      - text: Delete guest message {messageId} from reservation {reservationId} at hotel {hotelId}.
        slots:
          messageId: path.guestMessageId
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove message {messageId} left for booking {reservationId} at hotel {hotelId}.
        slots:
          messageId: path.guestMessageId
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/header/action/validate'].put
  update:
    x-apievangelist-phrasing:
      intent: Validate a reservation header change
      effect: read
      questions:
      - Will changing the stay dates or header details on this reservation pass validation?
      - Can I validate reservation header edits before saving them?
      instructions:
      - text: Validate header change {detail} on reservation {reservationId} at hotel {hotelId}.
        slots:
          detail: requestBody.newDetail
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Pre-check the header edits for booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/inventoryItems'].get
  update:
    x-apievangelist-phrasing:
      intent: Get inventory items reserved for a booking
      effect: read
      questions:
      - Which rollaway beds or cribs are reserved for this stay?
      - Can I see the inventory items held for a reservation?
      instructions:
      - text: List reserved inventory items for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show items held for booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/inventoryItems'].put
  update:
    x-apievangelist-phrasing:
      intent: Change inventory items reserved for a booking
      effect: write
      questions:
      - Can I change the quantity of an item already reserved for a guest?
      - How do I modify inventory items held on a reservation?
      instructions:
      - text: Update reserved inventory items {items} on reservation {reservationId} at hotel {hotelId}.
        slots:
          items: requestBody.inventoryItems
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Change the held items on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/inventoryItems'].post
  update:
    x-apievangelist-phrasing:
      intent: Reserve inventory items for a booking
      effect: write
      questions:
      - How do I reserve a crib or rollaway bed for a guest's stay?
      - Can I hold extra inventory items against a reservation?
      instructions:
      - text: Reserve inventory items {items} for reservation {reservationId} at hotel {hotelId}.
        slots:
          items: requestBody.inventoryItems
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Hold a rollaway bed for booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/inventoryItems'].delete
  update:
    x-apievangelist-phrasing:
      intent: Release inventory items reserved for a booking
      effect: destructive
      questions:
      - 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?
      instructions:
      - text: Delete reserved inventory items on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Release the held items for booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/linked'].get
  update:
    x-apievangelist-phrasing:
      intent: Get reservations linked to a reservation
      effect: read
      questions:
      - Which other reservations are linked to this booking?
      - Can I see the full linked reservations for a family's rooms?
      instructions:
      - text: Get linked reservations for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show bookings linked to {reservationId} at hotel {hotelId} with details {fetch}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          fetch: query.fetchInstructions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/linked'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a linked reservation
      effect: write
      questions:
      - Can I change the link details between two linked reservations?
      - How do I set a back-to-back reservation on a linked booking?
      instructions:
      - text: Update linked reservation info {info} for reservation {reservationId} at hotel {hotelId}.
        slots:
          info: requestBody.linkedReservationInfo
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Make booking {reservationId} at hotel {hotelId} back-to-back with {backToBack}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          backToBack: requestBody.backToBackToReservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/linkedSummary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a summary of linked reservations
      effect: read
      questions:
      - 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?
      instructions:
      - text: Summarize linked reservations for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show only back-to-back linked bookings in summary for {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/locks'].put
  update:
    x-apievangelist-phrasing:
      intent: Acquire a lock on a reservation
      effect: write
      questions:
      - How do I lock a reservation so nobody else edits it while I work?
      - Can I take over a reservation lock I already hold?
      instructions:
      - text: Acquire a lock on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Lock booking {reservationId} at hotel {hotelId} for editing.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/locks/break'].post
  update:
    x-apievangelist-phrasing:
      intent: Break someone's lock on a reservation
      effect: write
      questions:
      - A reservation is stuck locked by another user, can I force the lock open?
      - How do I break an existing reservation lock?
      instructions:
      - text: Break the lock on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Force-release lock {lockHandle} held on booking {reservationId} at hotel {hotelId}.
        slots:
          lockHandle: requestBody.lockHandle
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/masterAccount'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a reservation's master account
      effect: write
      questions:
      - Can I edit the master account attached to a reservation?
      - How do I change master billing details on a booking?
      instructions:
      - text: Update master account {account} on reservation {reservationId} at hotel {hotelId}.
        slots:
          account: requestBody.masterAccount
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Change the master account for booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/masterAccount'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a master account for a reservation
      effect: write
      questions:
      - How do I set up a master account to collect charges for a reservation?
      - Can I create a master billing account on a booking?
      instructions:
      - text: Create master account {account} for reservation {reservationId} at hotel {hotelId}.
        slots:
          account: requestBody.masterAccount
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Open a new master account on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/masterAccount'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel a reservation's master account
      effect: destructive
      questions:
      - How do I cancel the master account on a reservation?
      - Can I remove master billing from a booking?
      instructions:
      - text: Cancel the master account on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Close out master billing for booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/mergeReservations'].put
  update:
    x-apievangelist-phrasing:
      intent: Merge multiple reservations into one
      effect: write
      questions:
      - Can I merge duplicate reservations for the same guest?
      - How do I combine several bookings into a single reservation?
      instructions:
      - text: Merge reservations {toIds} with reservation {reservationId} at hotel {hotelId}.
        slots:
          toIds: requestBody.toReservationIDList
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Merge duplicate bookings from {fromId} at hotel {hotelId} starting with {reservationId}.
        slots:
          fromId: requestBody.fromReservationID
          hotelId: path.hotelId
          reservationId: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/move'].put
  update:
    x-apievangelist-phrasing:
      intent: Move a reservation to a different hotel
      effect: write
      questions:
      - How do I walk a guest by moving their reservation to a sister property?
      - Can I transfer a booking from one hotel to another?
      instructions:
      - text: Move reservation {reservationId} from hotel {hotelId} using {criteria}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          criteria: requestBody.criteria
      - text: Transfer booking {reservationId} at hotel {hotelId} to another property.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/packages'].get
  update:
    x-apievangelist-phrasing:
      intent: Check package availability for a reservation
      effect: read
      questions:
      - Is a particular package available for this guest's stay?
      - Can I check package availability by product code and dates?
      instructions:
      - text: Check availability of package {product} for reservation {reservationId} at hotel {hotelId}.
        slots:
          product: query.productCode
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: See if package {product} can be added to booking {reservationId} at hotel {hotelId} for {qty} units.
        slots:
          product: query.productCode
          reservationId: path.reservationId
          hotelId: path.hotelId
          qty: query.packageQuantity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/packages'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a package already on a reservation
      effect: write
      questions:
      - How do I change the dates or quantity of a package already on a booking?
      - Can I edit existing packages on a reservation?
      instructions:
      - text: Update packages {packages} on reservation {reservationId} at hotel {hotelId}.
        slots:
          packages: requestBody.reservationPackages
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Edit the existing package on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/packages'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a package to a reservation
      effect: write
      questions:
      - How do I add a breakfast or parking package to a guest's booking?
      - Can I attach new packages to an existing reservation?
      instructions:
      - text: Add packages {packages} to reservation {reservationId} at hotel {hotelId}.
        slots:
          packages: requestBody.reservationPackages
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Attach a new package to booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/packages'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a package from a reservation
      effect: destructive
      questions:
      - How do I take a package off a guest's reservation?
      - Can I delete packages from a booking?
      instructions:
      - text: Delete packages from reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove the package attached to booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/payeeSharer'].put
  update:
    x-apievangelist-phrasing:
      intent: Mark a share reservation as the payee
      effect: write
      questions:
      - Which sharer pays for the room, and can I change that?
      - How do I mark one shared reservation as the payee for the group?
      instructions:
      - text: Set reservation {reservationId} at hotel {hotelId} as payee sharer with {share}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          share: requestBody.shareReservation
      - text: Unmark booking {reservationId} at hotel {hotelId} as the paying sharer.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/paymentMethods'].get
  update:
    x-apievangelist-phrasing:
      intent: Get payment methods on a reservation
      effect: read
      questions:
      - What payment methods are on file for this reservation?
      - Can I see the amounts attached to each payment method on a booking?
      instructions:
      - text: List payment methods on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show payment methods with amounts {amounts} for booking {reservationId} at hotel {hotelId}.
        slots:
          amounts: query.includeAmounts
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/paymentMethods'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a payment method on a reservation
      effect: write
      questions:
      - How do I update the card on file for a reservation?
      - Can I change an existing payment method on a booking?
      instructions:
      - text: Update payment methods {methods} on reservation {reservationId} at hotel {hotelId}.
        slots:
          methods: requestBody.reservationPaymentMethods
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Change the payment method already on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/paymentMethods'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a payment method to a reservation
      effect: write
      questions:
      - How do I add a credit card to a guest's reservation?
      - Can I attach a second payment method to a booking?
      instructions:
      - text: Add payment method {methods} to reservation {reservationId} at hotel {hotelId}.
        slots:
          methods: requestBody.reservationPaymentMethods
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Attach a new payment method to booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/paymentMethods'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a payment method from a reservation
      effect: destructive
      questions:
      - How do I remove a card from a guest's reservation?
      - Can I delete a payment method on a booking?
      instructions:
      - text: Delete the payment method from reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove the card on file for booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/policies'].get
  update:
    x-apievangelist-phrasing:
      intent: Get deposit and cancellation policies on a reservation
      effect: read
      questions:
      - What deposit and cancellation policies are attached to this booking?
      - Can I fetch only the cancellation policies on a reservation?
      instructions:
      - text: Get the policies on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show only cancellation policies {cancel} for booking {reservationId} at hotel {hotelId}.
        slots:
          cancel: query.fetchCancellationPolicies
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/preCheckIn'].post
  update:
    x-apievangelist-phrasing:
      intent: Pre-check-in a reservation
      effect: write
      questions:
      - How do I pre-register a guest before they arrive?
      - Can a guest pre-check-in and view their folio on mobile?
      instructions:
      - text: Pre-check-in reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Mark booking {reservationId} at hotel {hotelId} as pre-registered with {reservation}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          reservation: requestBody.reservation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/preCheckIn'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revert a pre-check-in with DELETE
      effect: destructive
      questions:
      - 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?
      instructions:
      - text: Revert the pre-check-in on reservation {reservationId} at hotel {hotelId} via DELETE.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Undo pre-registration for booking {reservationId} at hotel {hotelId} in room {room} with a DELETE call.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          room: query.roomNumber
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/preCheckIn/deletions'].post
  update:
    x-apievangelist-phrasing:
      intent: Revert a pre-check-in with a POST body
      effect: destructive
      questions:
      - 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?
      instructions:
      - text: Post a pre-check-in reversal for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Submit a deletion request body to undo pre-registration on booking {reservationId} at hotel {hotelId} for room {room}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          room: requestBody.roomId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/preferences'].get
  update:
    x-apievangelist-phrasing:
      intent: Get guest preferences on a reservation
      effect: read
      questions:
      - What room preferences did the guest request on this booking?
      - Can I filter reservation preferences by preference type?
      instructions:
      - text: Get preferences on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show {type} preferences for booking {reservationId} at hotel {hotelId}.
        slots:
          type: query.preferenceTypeCode
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/preferences'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a preference to a reservation
      effect: write
      questions:
      - How do I note that a guest wants a high floor?
      - Can I add a room preference to an existing booking?
      instructions:
      - text: Add preferences {prefs} to reservation {reservationId} at hotel {hotelId}.
        slots:
          prefs: requestBody.reservationPreferences
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Record a feather-free pillow preference on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/preferences/{preferenceCode}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a preference on a reservation
      effect: write
      questions:
      - Can I change one of a guest's existing reservation preferences?
      - How do I update a preference code on a booking?
      instructions:
      - text: Change preference {code} on reservation {reservationId} at hotel {hotelId}.
        slots:
          code: path.preferenceCode
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Update preference {code} on booking {reservationId} at hotel {hotelId} to {prefs}.
        slots:
          code: path.preferenceCode
          reservationId: path.reservationId
          hotelId: path.hotelId
          prefs: requestBody.reservationPreferences
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/preferences/{preferenceCode}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a preference from a reservation
      effect: destructive
      questions:
      - How do I delete a preference a guest no longer wants?
      - Can I remove a specific preference code from a booking?
      instructions:
      - text: Delete preference {code} from reservation {reservationId} at hotel {hotelId}.
        slots:
          code: path.preferenceCode
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove the {code} preference on booking {reservationId} at hotel {hotelId}.
        slots:
          code: path.preferenceCode
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/reverseDepositPolicy/{policyId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Reverse a deposit policy on a reservation
      effect: destructive
      questions:
      - Can I reverse a deposit policy that was applied to a reservation?
      - How do I undo a deposit requirement on a booking?
      instructions:
      - text: Reverse deposit policy {policyId} on reservation {reservationId} at hotel {hotelId}.
        slots:
          policyId: path.policyId
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Undo deposit rule {policyId} applied to booking {reservationId} at hotel {hotelId}.
        slots:
          policyId: path.policyId
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/routingInstructions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a reservation's routing instructions
      effect: read
      questions:
      - Where are this guest's charges being routed?
      - Can I include comp routing requests when fetching routing instructions?
      instructions:
      - text: Get routing instructions for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show charge routing on booking {reservationId} at hotel {hotelId} effective {date}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          date: query.effectiveOn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/routingInstructions'].put
  update:
    x-apievangelist-phrasing:
      intent: Change routing instructions on a reservation
      effect: write
      questions:
      - How do I modify where a reservation's charges are routed?
      - Can I edit existing routing on a booking by its internal ID?
      instructions:
      - text: Replace the routing on OPERA reservation {reservationId} at hotel {hotelId} with {criteria}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          criteria: requestBody.criteria
      - text: Edit the existing charge routing for booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/routingInstructions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create routing instructions on a reservation
      effect: write
      questions:
      - 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?
      instructions:
      - text: Set up routing {criteria} so charges on OPERA reservation {reservationId} at hotel {hotelId} go elsewhere.
        slots:
          criteria: requestBody.criteria
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Route room and tax charges for booking {reservationId} at hotel {hotelId} to a separate window.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/routingInstructions'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete routing instructions from a reservation
      effect: destructive
      questions:
      - How do I stop routing charges on a reservation?
      - Can I delete all routing instructions from a booking?
      instructions:
      - text: Delete routing instructions on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove charge routing from booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/scheduledRoomMoves/{scheduledMoveDate}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a scheduled room move
      effect: write
      questions:
      - Can I change the time of a room move already scheduled for a guest?
      - How do I add comments to a scheduled room move?
      instructions:
      - text: Update the room move on {moveDate} for reservation {reservationId} at hotel {hotelId} to time {time}.
        slots:
          moveDate: path.scheduledMoveDate
          reservationId: path.reservationId
          hotelId: path.hotelId
          time: requestBody.scheduledMoveTime
      - text: Add comment {comments} to the {moveDate} room move for booking {reservationId} at hotel {hotelId}.
        slots:
          comments: requestBody.moveComments
          moveDate: path.scheduledMoveDate
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/separatedShare'].put
  update:
    x-apievangelist-phrasing:
      intent: Separate a share and apply external daily rates
      effect: write
      questions:
      - 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?
      instructions:
      - text: Separate share reservation {reservationId} at hotel {hotelId} applying external daily rates {criteria}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          criteria: requestBody.criteria
      - text: Split share {reservationId} at hotel {hotelId} with rates from our system, overriding rate availability {override}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          override: query.overrideRateAvailabilityCheck
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/shareRateAmount'].put
  update:
    x-apievangelist-phrasing:
      intent: Change share rate amounts
      effect: write
      questions:
      - How do I split the room rate differently between sharers?
      - Can I change the share amounts on a shared reservation?
      instructions:
      - text: Change the share rate amounts on reservation {reservationId} at hotel {hotelId} to {criteria}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          criteria: requestBody.criteria
      - text: Rebalance what each sharer pays on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/sharedGuestCount'].put
  update:
    x-apievangelist-phrasing:
      intent: Change guest counts on a sharing reservation
      effect: write
      questions:
      - Can I change the number of adults or children on a sharing reservation?
      - How do I update guest counts for sharers in a room?
      instructions:
      - text: Change sharing guest counts on reservation {reservationId} at hotel {hotelId} to {reservations}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          reservations: requestBody.reservations
      - text: Add a child to the sharers on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/shares'].get
  update:
    x-apievangelist-phrasing:
      intent: Get share reservations on a reservation
      effect: read
      questions:
      - Who is sharing the room on this reservation?
      - Can I list the sharers on a booking by its internal ID?
      instructions:
      - text: Who shares OPERA reservation {reservationId} at hotel {hotelId}? List them.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show sharers of booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/shares'].post
  update:
    x-apievangelist-phrasing:
      intent: Combine reservations into a share
      effect: write
      questions:
      - 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?
      instructions:
      - text: Join OPERA reservation {reservationId} at hotel {hotelId} into a room share using {criteria}.
        slots:
          criteria: requestBody.criteria
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Make booking {reservationId} at hotel {hotelId} a share with another guest's reservation.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/shares'].delete
  update:
    x-apievangelist-phrasing:
      intent: Separate share reservations
      effect: destructive
      questions:
      - How do I break sharers apart into their own rooms?
      - Can I separate shares and get the remaining share reservations back?
      instructions:
      - text: Separate share reservations on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Break the share on booking {reservationId} at hotel {hotelId}, overriding max occupancy {override}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          override: query.overrideMaxOccupancyCheck
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/stay/action/validate'].put
  update:
    x-apievangelist-phrasing:
      intent: Check one reservation for overlapping stays
      effect: read
      questions:
      - Does this guest already have another stay overlapping this reservation?
      - Can I check a single booking for overlapping dates?
      instructions:
      - text: Check reservation {reservationId} at hotel {hotelId} for overlapping stays.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Validate overlap info {info} for booking {reservationId} at hotel {hotelId}.
        slots:
          info: requestBody.overlappingStayInfo
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/tickets'].get
  update:
    x-apievangelist-phrasing:
      intent: Get tickets on a reservation
      effect: read
      questions:
      - What event or attraction tickets are on this guest's booking?
      - Can I list only tickets that haven't been issued yet?
      instructions:
      - text: List tickets on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show tickets for package {package} on booking {reservationId} at hotel {hotelId}.
        slots:
          package: query.packageCode
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/tickets'].put
  update:
    x-apievangelist-phrasing:
      intent: Change tickets on a reservation
      effect: write
      questions:
      - How do I modify tickets already on a reservation?
      - Can I change the ticket details on a booking?
      instructions:
      - text: Update tickets {tickets} on reservation {reservationId} at hotel {hotelId}.
        slots:
          tickets: requestBody.tickets
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Change the existing tickets on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/tickets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create tickets on a reservation
      effect: write
      questions:
      - How do I add attraction tickets to a guest's reservation?
      - Can I create new tickets on a booking before issuing them?
      instructions:
      - text: Create tickets {tickets} on reservation {reservationId} at hotel {hotelId}.
        slots:
          tickets: requestBody.tickets
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Add new tickets to booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/tickets'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete tickets from a reservation
      effect: destructive
      questions:
      - How do I delete tickets a guest no longer wants?
      - Can I remove all tickets from a booking?
      instructions:
      - text: Delete tickets from reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove the tickets on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/tickets/inquiry'].get
  update:
    x-apievangelist-phrasing:
      intent: Inquire about ticket status on a reservation
      effect: read
      questions:
      - What's the status of a specific ticket on a reservation?
      - Can I look up tickets by consumption date or rate code?
      instructions:
      - text: Run a ticket inquiry for ticket {ticketId} on reservation {reservationId} at hotel {hotelId}.
        slots:
          ticketId: query.ticketId
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Inquire about tickets with status {status} on booking {reservationId} at hotel {hotelId}.
        slots:
          status: query.ticketStatus
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/tickets/issue'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue tickets for a reservation
      effect: write
      questions:
      - How do I issue the tickets a guest booked so they can use them?
      - Can I issue reservation tickets once they're created?
      instructions:
      - text: Issue tickets {tickets} for reservation {reservationId} at hotel {hotelId}.
        slots:
          tickets: requestBody.tickets
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Issue the pending tickets on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/tickets/refund'].delete
  update:
    x-apievangelist-phrasing:
      intent: Refund tickets on a reservation
      effect: destructive
      questions:
      - How do I refund tickets a guest bought with their stay?
      - Can I refund issued reservation tickets?
      instructions:
      - text: Refund tickets on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Give the guest on booking {reservationId} at hotel {hotelId} a ticket refund.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/tickets/reprint'].get
  update:
    x-apievangelist-phrasing:
      intent: Reprint tickets for a reservation
      effect: read
      questions:
      - A guest lost their ticket, can I reprint it?
      - Is it possible to reprint a single ticket by ticket number?
      instructions:
      - text: Reprint tickets for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Reprint ticket number {ticketNumber} on booking {reservationId} at hotel {hotelId}.
        slots:
          ticketNumber: query.ticketNumberId
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/traces'].get
  update:
    x-apievangelist-phrasing:
      intent: Get traces for a reservation
      effect: read
      questions:
      - What follow-up traces are set on this guest's reservation?
      - Can I see department traces for a booking?
      instructions:
      - text: Get traces for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show follow-up tasks traced on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/transactionDiversions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get transaction diversions on a reservation
      effect: read
      questions:
      - Which transaction diversions apply to this reservation?
      - Can I include daily details when listing transaction diversions?
      instructions:
      - text: Get transaction diversions on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show diversion codes {codes} with daily details for booking {reservationId} at hotel {hotelId}.
        slots:
          codes: query.transactionDiversionCodes
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/transactionDiversions'].put
  update:
    x-apievangelist-phrasing:
      intent: Change transaction diversions on a reservation
      effect: write
      questions:
      - How do I edit transaction diversions already on a booking?
      - Can I modify an existing transaction diversion?
      instructions:
      - text: Update transaction diversions {diversions} on reservation {reservationId} at hotel {hotelId}.
        slots:
          diversions: requestBody.transactionDiversions
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Change the existing diversions on booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/transactionDiversions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create transaction diversions on a reservation
      effect: write
      questions:
      - How do I add a transaction diversion to a reservation?
      - Can I set up new transaction diversions for a guest's stay?
      instructions:
      - text: Create transaction diversions {diversions} on reservation {reservationId} at hotel {hotelId}.
        slots:
          diversions: requestBody.transactionDiversions
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Add a new diversion to booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/transactionDiversions'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete transaction diversions from a reservation
      effect: destructive
      questions:
      - How do I remove transaction diversions from a booking?
      - Can I delete every transaction diversion on a reservation?
      instructions:
      - text: Delete transaction diversions on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove the diversions from booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/upgradeEligibleReservations'].put
  update:
    x-apievangelist-phrasing:
      intent: Set upgrade eligibility for reservations
      effect: write
      questions:
      - Can I flag reservations as eligible for a room upgrade?
      - How do I mark a booking as not upgrade eligible?
      instructions:
      - text: Set upgrade eligibility {eligibility} for reservation {reservationId} at hotel {hotelId}.
        slots:
          eligibility: requestBody.upgradeEligibilityListType
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Mark booking {reservationId} at hotel {hotelId} as upgrade eligible.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/upsell'].get
  update:
    x-apievangelist-phrasing:
      intent: Get upsell offers available for a reservation
      effect: read
      questions:
      - What room upgrade offers can I pitch to this guest?
      - Are there any upsell options configured for this reservation?
      instructions:
      - text: Get available upsell offers for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Show upgrade offers the guest on booking {reservationId} at hotel {hotelId} qualifies for.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/upsell'].post
  update:
    x-apievangelist-phrasing:
      intent: Upsell a reservation to a better room
      effect: write
      questions:
      - How do I apply a paid room upgrade to a guest's reservation?
      - Can I override the upsell rules when upselling a booking?
      instructions:
      - text: Upsell reservation {reservationId} at hotel {hotelId} with offer {upsell}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          upsell: requestBody.upsell
      - text: Apply the room upgrade to booking {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/upsell'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an upsell from a reservation
      effect: destructive
      questions:
      - How do I undo an upgrade that was sold on a reservation?
      - Can I remove an upsell and override inventory?
      instructions:
      - text: Delete the upsell on reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
      - text: Remove the upgrade from booking {reservationId} at hotel {hotelId}, overriding inventory {override}.
        slots:
          reservationId: path.reservationId
          hotelId: path.hotelId
          override: query.overrideInventory
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/roomCalendar'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a hotel's room calendar
      effect: read
      questions:
      - Which rooms are assigned or free across the next few weeks?
      - Can I view the room calendar for one room type or floor?
      - How many days can a room calendar request span?
      instructions:
      - text: Show the room calendar for hotel {hotelId} from {start} to {end}.
        slots:
          hotelId: path.hotelId
          start: query.startDate
          end: query.endDate
      - text: Get the room calendar at hotel {hotelId} for room type {roomType}.
        slots:
          hotelId: path.hotelId
          roomType: query.roomType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/rooms/{roomId}/traces'].get
  update:
    x-apievangelist-phrasing:
      intent: Get traces for a room
      effect: read
      questions:
      - What traces are set on a particular room?
      - Can I see follow-up tasks tied to a room number rather than a booking?
      instructions:
      - text: Get traces for room {roomId} at hotel {hotelId}.
        slots:
          roomId: path.roomId
          hotelId: path.hotelId
      - text: Show follow-ups logged against room {roomId} at hotel {hotelId}.
        slots:
          roomId: path.roomId
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/script'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a property's reservation script
      effect: read
      questions:
      - What script should my agents read when taking a reservation?
      - Can I get the property script in another language?
      instructions:
      - text: Get the script for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Fetch the {type} script at hotel {hotelId} in language {lang}.
        slots:
          type: query.scriptType
          hotelId: path.hotelId
          lang: query.languageCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/sellMessages/config'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a property's sell message configuration
      effect: read
      questions:
      - Which sell messages are configured for my property?
      - Can I filter a hotel's sell message setup by room type or rate plan?
      instructions:
      - text: List sell message configuration at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Show sell message setup at hotel {hotelId} for rate plan {ratePlan}.
        slots:
          hotelId: path.hotelId
          ratePlan: query.ratePlanCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/sellMessages/config'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a property's sell message
      effect: write
      questions:
      - How do I edit a sell message shown to reservation agents at my hotel?
      - Can I update property-level sell message configuration?
      instructions:
      - text: Update sell message configuration {configs} at hotel {hotelId}.
        slots:
          configs: requestBody.sellMessageConfigs
          hotelId: path.hotelId
      - text: Change the existing sell message text for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/sellMessages/config'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a sell message for a property
      effect: write
      questions:
      - How do I add a new sell message agents see when booking my hotel?
      - Can I create property-specific sell messages by room type?
      instructions:
      - text: Create sell message configuration {configs} at hotel {hotelId}.
        slots:
          configs: requestBody.sellMessageConfigs
          hotelId: path.hotelId
      - text: Add a new sell message for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/sellMessages/config'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a property's sell message
      effect: destructive
      questions:
      - How do I remove a sell message from my hotel's configuration?
      - Can I delete property-level sell messages?
      instructions:
      - text: Delete the sell message configuration at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Remove the property sell message for hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/stay/action/validate'].put
  update:
    x-apievangelist-phrasing:
      intent: Check prospective stays for overlaps at a hotel
      effect: read
      questions:
      - 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?
      instructions:
      - text: Before booking at hotel {hotelId}, run a property-level overlap check on {info}.
        slots:
          hotelId: path.hotelId
          info: requestBody.overlappingStayInfo
      - text: Validate that a new stay at hotel {hotelId} doesn't overlap the guest's other bookings.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/turnaways'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a turnaway at a property
      effect: write
      questions:
      - 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?
      instructions:
      - text: Register turnaway {turnaway} at hotel {hotelId}.
        slots:
          turnaway: requestBody.turnaway
          hotelId: path.hotelId
      - text: Log a denied booking request at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/profiles/{profileId}/reservations'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a profile for future reservations or blocks
      effect: read
      questions:
      - Does this guest profile have any upcoming reservations or business blocks?
      - Before merging a profile, can I see whether it has future bookings?
      instructions:
      - text: Check whether profile {profileId} has future reservations or blocks.
        slots:
          profileId: path.profileId
      - text: List upcoming stays tied to profile {profileId}.
        slots:
          profileId: path.profileId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/recentlyAccessedReservations'].get
  update:
    x-apievangelist-phrasing:
      intent: Get recently accessed reservations
      effect: read
      questions:
      - Which reservations did I open most recently?
      - Can I list reservations accessed on a specific date?
      instructions:
      - text: Show my recently accessed reservations.
      - text: List reservations accessed on {date}, up to {limit}.
        slots:
          date: query.accessDate
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservations'].get
  update:
    x-apievangelist-phrasing:
      intent: Find reservations across hotels
      effect: read
      questions:
      - How do I search reservations across several hotels at once?
      - Can I find bookings chain-wide by guest email or phone?
      instructions:
      - text: Find reservations across hotels {hotelIds} for surname {surname}.
        slots:
          hotelIds: query.hotelIds
          surname: query.surname
      - text: List chain-wide reservations with confirmation number {confirmation}.
        slots:
          confirmation: query.confirmationNumberList
      - text: Look up bookings across all properties by guest email {email}.
        slots:
          email: query.email
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservations/indicators'].get
  update:
    x-apievangelist-phrasing:
      intent: Get indicators for a reservation
      effect: read
      questions:
      - What indicators, like traces or alerts, are flagged on a reservation?
      - Can I see the status flags for a booking at a glance?
      instructions:
      - text: Get indicators for reservation {reservationId} at hotel {hotelId}.
        slots:
          reservationId: query.reservationId
          hotelId: query.hotelId
      - text: Show the flags set on booking {reservationId}.
        slots:
          reservationId: query.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservations/linkedReservations/{reservationId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Link reservations at chain level
      effect: write
      questions:
      - Can I link reservations across properties at the chain level?
      - How do I link bookings without specifying a hotel in the path?
      instructions:
      - text: Link reservations {ids} to reservation {reservationId} at chain level.
        slots:
          ids: requestBody.reservationIdList
          reservationId: path.reservationId
      - text: Create a chain-level link from other bookings to {reservationId}.
        slots:
          reservationId: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservations/linkedReservations/{reservationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink a reservation at chain level
      effect: destructive
      questions:
      - 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?
      instructions:
      - text: Remove chain-level links on reservation {reservationId}.
        slots:
          reservationId: path.reservationId
      - text: Unlink booking {reservationId} from its chain-level linked reservation.
        slots:
          reservationId: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservations/searches'].post
  update:
    x-apievangelist-phrasing:
      intent: Search reservations across hotels via request body
      effect: read
      questions:
      - 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?
      instructions:
      - text: Run a body search of reservations across hotels {hotelIds} for surname {surname}.
        slots:
          hotelIds: requestBody.hotelIds
          surname: requestBody.surname
      - text: Submit a multi-hotel reservation search for arrivals from {from} to {to}.
        slots:
          from: requestBody.arrivalStartDate
          to: requestBody.arrivalEndDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservations/{reservationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an on-hold reservation without a hotel path
      effect: destructive
      questions:
      - 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?
      instructions:
      - text: Delete on-hold reservation {reservationId} by ID alone.
        slots:
          reservationId: path.reservationId
      - text: Discard held in-session booking {reservationId} at the chain level.
        slots:
          reservationId: path.reservationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservations/{reservationId}/split'].put
  update:
    x-apievangelist-phrasing:
      intent: Split a multi-room reservation
      effect: write
      questions:
      - How do I split a booking for three rooms into separate reservations?
      - Can I copy payment details when splitting a multi-room reservation?
      instructions:
      - text: Split multi-room reservation {reservationId}.
        slots:
          reservationId: path.reservationId
      - text: Split every room out of booking {reservationId} and copy payment info {copy}.
        slots:
          reservationId: path.reservationId
          copy: requestBody.copyPaymentInformation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sellMessages'].get
  update:
    x-apievangelist-phrasing:
      intent: Get sell messages to show while booking
      effect: read
      questions:
      - 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?
      instructions:
      - text: Get sell messages for hotel {hotelId} and rate plan {ratePlan}.
        slots:
          hotelId: query.hotelId
          ratePlan: query.ratePlanCode
      - text: Show sell messages for room type {roomType} from {start} to {end}.
        slots:
          roomType: query.roomType
          start: query.startDate
          end: query.endDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sellMessages/config'].get
  update:
    x-apievangelist-phrasing:
      intent: Get chain-level sell message configuration
      effect: read
      questions:
      - Which sell messages are configured across my whole chain?
      - Can I filter chain sell message setup by CRO code?
      instructions:
      - text: List chain-level sell message configuration for chain {chainId}.
        slots:
          chainId: query.chainId
      - text: Show chain sell message setup for CRO {cro}.
        slots:
          cro: query.croCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sellMessages/config'].put
  update:
    x-apievangelist-phrasing:
      intent: Change chain-level sell messages
      effect: write
      questions:
      - How do I update a sell message configured at the chain level?
      - Can I edit sell messages that apply across all my hotels?
      instructions:
      - text: Update chain-level sell message configuration {configs}.
        slots:
          configs: requestBody.sellMessageConfigs
      - text: Change the existing chain-wide sell message text.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sellMessages/config'].post
  update:
    x-apievangelist-phrasing:
      intent: Create chain-level sell messages
      effect: write
      questions:
      - 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?
      instructions:
      - text: Create chain-level sell message configuration {configs}.
        slots:
          configs: requestBody.sellMessageConfigs
      - text: Add a new chain-wide sell message.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sellMessages/config'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a chain-level sell message
      effect: destructive
      questions:
      - How do I remove a chain-level sell message configuration?
      - Can I delete one chain sell message by its config ID?
      instructions:
      - text: Delete chain sell message configuration {configId}.
        slots:
          configId: query.sellMessageConfigId
      - text: Remove chain-wide sell message {configId}.
        slots:
          configId: query.sellMessageConfigId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/services/reservations/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the reservation service version
      effect: read
      questions:
      - Is the reservation service up, and which version is running?
      - Can I ping the OPERA reservation API for a health check?
      instructions:
      - text: Ping the reservation service.
      - text: Get the current reservation service version for hotel {hotel}.
        slots:
          hotel: header.x-hotelid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/turnaways'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a hub turnaway across properties
      effect: write
      questions:
      - How do I log a turnaway for a destination or multiple properties at once?
      - Can a central reservations office record hub-level turnaways?
      instructions:
      - text: Register hub turnaway {turnaway} for CRO {cro}.
        slots:
          turnaway: requestBody.turnaway
          cro: requestBody.croCode
      - text: Log a destination-wide turnaway for multiple properties.
      method: generated
      generated: '2026-09-26'