> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Update CancelledBooking
> Update an existing CancelledBooking record.
Updates an existing CancelledBooking record. You must include the `Id` of the record to update along with all required fields.
## Authentication
This endpoint requires OAuth2 authentication. Include a valid bearer token in the `Authorization` header.
The authenticated user must be a full unrestricted administrator or have the **`CancelledBooking-Edit`** role.
## Enums
| Value | Name |
| ----- | ------------------------- |
| 0 | Unknown |
| 1 | NoLongerNeeded |
| 2 | TooExpensive |
| 3 | BadPreviousExperience |
| 4 | RebookedForADifferentTime |
| 5 | FailedToPayUpfront |
| 6 | Integration |
| 7 | Other |
| 8 | NotCheckedIn |
| 9 | MarketPlace |
## Request Body
### Required Fields
The Id of the CancelledBooking record to update.
Resource Id.
Booking start time.
Booking end time.
Repeats.
Which Bookings To Update.
Date and time when the booking was cancelled.
### Optional Fields
Floor Plan Desk Id.
Coworker Id.
Extra Service Id.
Notes.
Internal Notes.
Charge Now.
Invoice Now.
Invoice This Coworker.
Do Not Use Booking Credit.
Purchase Order.
Discount Code.
Last Notification Time.
Google Calendar Id.
Google Event Id.
Office365Event Id.
Public Google Event Id.
Tentative booking. Must be approved by an administrator before confirmed or charged. Tentative bookings still block the calendar.
Online.
Teams At The Time Of Booking.
Tariff At The Time Of Booking.
Repeat Series Unique Id.
Repeat Booking.
Repeat Every.
Repeat Until.
Repeat On Mondays.
Repeat On Tuesdays.
Repeat On Wednesdays.
Repeat On Thursdays.
Repeat On Fridays.
Repeat On Saturdays.
Repeat On Sundays.
Reminded.
Mrm Reminded.
Override Price.
Whether the booking had been charged. When true, a charge (CoworkerExtraService) had been posted to the customer account.
Invoice Date.
Booking Number.
Kisi Key Id.
Start Scheduled Job Id.
End Scheduled Job Id.
Billed.
From Time Local.
To Time Local.
Invoice Date Local.
Coworker Invoice Id.
Coworker Invoice Number.
Coworker Invoice Paid.
Coworker Invoice Draft.
Coworker Invoice Void.
Coworker Invoice Credit Note.
Coworker Extra Service Ids.
Coworker Extra Service Price.
Coworker Extra Service Currency Code.
Coworker Extra Service Charge Period.
Coworker Extra Service Total Uses.
Include Zoom Invite.
Zoom Event Data.
Checked In At.
Cancel If Not Paid.
Cancel If Not Checked In.
Max Occupancy.
Last Minute Price Adjustment.
Dynamic Price Adjustment.
Price Factor Last Minute.
Price Factor Demand.
Office365Admin Event Id.
Reason the booking was cancelled, e.g. NoLongerNeeded, TooExpensive, or NotCheckedIn. See `eBookingCancellationReason?` enum above.
Name or identifier of the user who cancelled the booking.
Additional free-text details explaining the cancellation reason.
Booking price.
Original Booking Id.
## Code Examples
```bash cURL theme={null}
curl -X PUT \
"https://spaces.nexudus.com/api/spaces/cancelledbookings" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"ResourceId": 0,
"FromTime": "2025-01-15T10:30:00Z",
"ToTime": "2025-01-15T10:30:00Z",
"Repeats": 0,
"WhichBookingsToUpdate": 0,
"CancelledOn": "2025-01-15T10:30:00Z",
"Id": 87654321
}'
```
```javascript JavaScript theme={null}
const response = await fetch(
'https://spaces.nexudus.com/api/spaces/cancelledbookings',
{
method: 'PUT',
headers: {
'Authorization': 'Bearer YOUR_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
ResourceId: 0,
FromTime: '2025-01-15T10:30:00Z',
ToTime: '2025-01-15T10:30:00Z',
Repeats: 0,
WhichBookingsToUpdate: 0,
CancelledOn: '2025-01-15T10:30:00Z',
Id: 87654321
})
}
);
const data = await response.json();
```
```python Python theme={null}
import requests
response = requests.put(
'https://spaces.nexudus.com/api/spaces/cancelledbookings',
headers={
'Authorization': 'Bearer YOUR_TOKEN',
'Content-Type': 'application/json'
},
json={
'ResourceId': 0,
'FromTime': '2025-01-15T10:30:00Z',
'ToTime': '2025-01-15T10:30:00Z',
'Repeats': 0,
'WhichBookingsToUpdate': 0,
'CancelledOn': '2025-01-15T10:30:00Z',
'Id': 87654321
}
)
data = response.json()
```
## Response
### 200
HTTP status code. `200` on success.
A human-readable message confirming the update.
Contains the `Id` of the updated record.
`true` if the cancelledbooking was updated successfully.
`null` on success.
```json Example Response theme={null}
{
"Status": 200,
"Message": "CancelledBooking was successfully updated.",
"Value": {
"Id": 87654321
},
"OpenInDialog": false,
"OpenInWindow": false,
"RedirectURL": null,
"JavaScript": null,
"UpdatedOn": "2025-01-15T10:30:00Z",
"UpdatedBy": "admin@example.com",
"Errors": null,
"WasSuccessful": true
}
```
### 400
A summary of the validation error(s), in the format `PropertyName: error message`.
`null` on validation failure.
Array of validation errors.
The value that was submitted for the field, or `null` if missing.
The validation error message.
The name of the property that failed validation.
`false` when the request fails validation.
```json Example Response theme={null}
{
"Message": "FromTime: is a required field",
"Value": null,
"Errors": [
{
"AttemptedValue": null,
"Message": "is a required field",
"PropertyName": "FromTime"
}
],
"WasSuccessful": false
}
```