POST

Reservations.Edit

Update a room reservation. This uses the existing reservation workflow so payments, channel ids, custom fields, room availability checks, automation, and calendar side effects stay consistent.

Permissions

User must be logged in with a valid bearer token.
Returned or changed records are limited by the user permissions, team access, folder access, and account settings.

Action

Updates the requested Reservations record after validating permissions and input fields.

Push Service

No push is sent because this function only reads data or returns helper information.

Automation

No automation is run for this function.

Special Instructions

Send the bearer token on protected calls with Authorization: Bearer YOUR TOKEN.
Send parameters as POST body fields exactly as documented.
Send date/time values in UTC Y-m-d H:i:s format when a date or datetime field is used.

Required Parameters

Name	Type	Sample	Explanation
`reservation_id` post	int	`88`	Reservation id from rooms_for_cust. You may also send rooms_for_cust_id.
`room_id` post	int	`3710`	Room id for the reservation.
`cust_id` post	int	`123`	Customer id for the reservation.
`start_date` post	date\|datetime	`2026-07-20`	Reservation start date. Send Y-m-d or Y-m-d H:i:s. Send UTC date/time as Y-m-d H:i:s, for example 2026-07-20 10:00:00. The SDK converts user local Date/local datetime input to UTC before posting.
`end_date` post	date\|datetime	`2026-07-22`	Reservation end date. Send UTC date/time as Y-m-d H:i:s, for example 2026-07-20 10:00:00. The SDK converts user local Date/local datetime input to UTC before posting.
`date` post	month	`2026-07`	Calendar month for the reservation, usually the start date month in Y-m.
`days` post	int	`2`	Number of booked days/nights. Must be more than zero.
`book_type` post	string	`nightly`	Room booking type, such as nightly or daily.
`total_price` post	number	`500`	Reservation total price.

Optional Parameters

Name	Type	Sample	What it gives
`notes` post	string	`Late check-in`	Reservation notes.
`paid_status` post	int	`0`	Payment state: 0 not paid, 1 paid, 2 partly paid. Paid/partly paid reservations require payment_method unless an existing method is already saved.
`payment_method` post	string	`cash`	Payment method for paid/partly paid reservations.
`payment_note` post	string	`Paid at desk`	Payment note preserved with the reservation.
`discount` post	number	`0`	Reservation discount percentage/value.
`room_display_name` post	string	`Daniel booking`	Display title shown on the room calendar.
`room_row_id` post	int	`0`	Specific occupancy row when a room supports more than one concurrent booking.
`channel_booking_id` post	string	`ABC123`	External channel booking id for sync/idempotency.

Authentication

Send the bearer token returned by Login in the request header.

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/Reservations.Edit",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "reservation_id": "88",
        "room_id": "3710",
        "cust_id": "123",
        "start_date": "2026-07-20",
        "end_date": "2026-07-22",
        "date": "2026-07",
        "days": "2",
        "book_type": "nightly",
        "total_price": "500"
    },
    "url_user": "https:\/\/{user}.bull36.com\/app\/Reservations.Edit",
    "url_domain": "https:\/\/{domain}\/app\/Reservations.Edit"
}

Endpoint

POST /app/Reservations.Edit
POST https://{user}.bull36.com/app/Reservations.Edit
POST https://{domain}/app/Reservations.Edit

Sample Output

{
    "success": 1,
    "message": "Room update successfully",
    "id": "88"
}

JavaScript Example

const token = 'YOUR TOKEN';
const body = new URLSearchParams({
  reservation_id: '88',
  room_id: '3710',
  cust_id: '123',
  start_date: '2026-07-20',
  end_date: '2026-07-22',
  date: '2026-07',
  days: '2',
  book_type: 'nightly',
  total_price: '500'
});

const res = await fetch('/app/Reservations.Edit', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + token },
  body
});

const data = await res.json();
console.log(data);

Error Example

{
    "success": 0,
    "message": "Room book failed"
}