CLcloudbeds
Room

postRoomAssign

Assign/Reassign a room on a guest reservation

post/postRoomAssign

Request

  • Base URL
    https://api.cloudbeds.com/api/v1.3
  • URL
    https://api.cloudbeds.com/api/v1.3/postRoomAssign
  • Auth
    • API key in header x-api-key
    • or OAuth 2
      Authorization code
      Scopes: write:room

Request body application/x-www-form-urlencoded

propertyIDstring nullable

Property ID

reservationIDstring

Reservation identifier

subReservationIDstring nullable

Sub Reservation identifier

reservationRoomIDstring nullable

Reservation room ID. Must be set if you want to unassign a room.

newRoomIDstring

Room ID of the room that will be assigned. Empty field must be sent if you want to unassign a room.

roomTypeIDstring nullable

Room Type ID of the room that will be assigned. Need to be provided in case of assignment.

oldRoomIDstring nullable

Room ID of the room that was assigned. Need to be provided in case of reassignment.

overrideRatesboolean nullable

Deprecated. Please use adjustPrice instead. Setting overrideRates=true will have the opposite of the effect that the name implies. It will cause the rates to NOT be overridden, but instead to be recalculated based on the new room assignment.

adjustPriceboolean nullable

If room assignment would result in an upcharge or discount, this parameter needs to be set to true to approve the charges. If not set, the rate will retain its original value.

Response

200 Response

successboolean

Returns if the request could be completed

messagestring nullable

To be used in case any error occurs (if success = false). If success = true, it does not exist.

Changes

No recorded changes to this operation across all 2 revisions of this API.