Skip to main content
PUT
/
api
/
spaces
/
cancelledbookings
Update CancelledBooking
curl --request PUT \
  --url https://spaces.nexudus.com/api/spaces/cancelledbookings \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Id": 123,
  "ResourceId": 123,
  "FromTime": "<string>",
  "ToTime": "<string>",
  "Repeats": 123,
  "WhichBookingsToUpdate": 123,
  "CancelledOn": "<string>"
}
'
{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}
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

ValueName
0Unknown
1NoLongerNeeded
2TooExpensive
3BadPreviousExperience
4RebookedForADifferentTime
5FailedToPayUpfront
6Integration
7Other
8NotCheckedIn
9MarketPlace
ValueName
1Daily
2Weekly
3Monthly
4Yearly
5FirstOfMonth
6SecondOfMonth
7ThirdOfMonth
8LastOfMonth
9FourthOfMonth
ValueName
1UpdateThisBookingOnly
2UpdateFutureBookingsOnly
3UpdateAllBookings
4UpdateNotChargedBookings
5DeleteAllBookings
6DeleteBookingsAfterThis
7DeleteNotChargedBookings
8RevertAllCharges

Request Body

Required Fields

Id
integer
required
The Id of the CancelledBooking record to update.
ResourceId
integer
required
ID of the resource linked to this record.
FromTime
string
required
Booking start time.
ToTime
string
required
Booking end time.
Repeats
integer
required
The repeats value for this cancelled booking.
WhichBookingsToUpdate
integer
required
Date/time value for which bookings to update.
CancelledOn
string
required
Date and time when the booking was cancelled.

Optional Fields

FloorPlanDeskId
integer
ID of the floor plan desk linked to this record.
CoworkerId
integer
ID of the coworker linked to this record.
ExtraServiceId
integer
ID of the extra service linked to this record.
Notes
string
Optional notes or comments about this cancelled booking.
InternalNotes
string
The internal notes value for this cancelled booking.
ChargeNow
boolean
Whether charge now is enabled.
InvoiceNow
boolean
Whether invoice now is enabled.
InvoiceThisCoworker
boolean
Whether invoice this coworker is enabled.
DoNotUseBookingCredit
boolean
Whether do not use booking credit is enabled.
PurchaseOrder
string
The purchase order value for this cancelled booking.
DiscountCode
string
The discount code value for this cancelled booking.
LastNotificationTime
string
Date/time value for last notification time.
GoogleCalendarId
string
ID of the google calendar associated with this record.
GoogleEventId
string
ID of the google event associated with this record.
Office365EventId
string
ID of the office365 event associated with this record.
PublicGoogleEventId
string
ID of the public google event associated with this record.
Tentative
boolean
Tentative booking. Must be approved by an administrator before confirmed or charged. Tentative bookings still block the calendar.
Online
boolean
Whether online is enabled.
TeamsAtTheTimeOfBooking
string
The teams at the time of booking value for this cancelled booking.
TariffAtTheTimeOfBooking
string
The tariff at the time of booking value for this cancelled booking.
RepeatSeriesUniqueId
string
ID of the repeat series unique associated with this record.
RepeatBooking
boolean
Whether repeat booking is enabled.
RepeatEvery
integer
The repeat every value for this cancelled booking.
RepeatUntil
string
Date/time value for repeat until.
RepeatOnMondays
boolean
Whether repeat on mondays is enabled.
RepeatOnTuesdays
boolean
Whether repeat on tuesdays is enabled.
RepeatOnWednesdays
boolean
Whether repeat on wednesdays is enabled.
RepeatOnThursdays
boolean
Whether repeat on thursdays is enabled.
RepeatOnFridays
boolean
Whether repeat on fridays is enabled.
RepeatOnSaturdays
boolean
Whether repeat on saturdays is enabled.
RepeatOnSundays
boolean
Whether repeat on sundays is enabled.
Reminded
boolean
Whether reminded is enabled.
MrmReminded
boolean
Whether mrm reminded is enabled.
OverridePrice
number
The override price value for this cancelled booking.
Invoiced
boolean
Whether the booking had been charged. When true, a charge (CoworkerExtraService) had been posted to the customer account.
InvoiceDate
string
Date/time value for invoice date.
BookingNumber
integer
The booking number value for this cancelled booking.
KisiKeyId
integer
ID of the kisi key associated with this record.
StartScheduledJobId
string
ID of the start scheduled job associated with this record.
EndScheduledJobId
string
ID of the end scheduled job associated with this record.
Billed
boolean
Whether billed is enabled.
FromTimeLocal
string
Date/time value for from time local.
ToTimeLocal
string
Date/time value for to time local.
InvoiceDateLocal
string
Date/time value for invoice date local.
CoworkerInvoiceId
integer
ID of the coworker invoice associated with this record.
CoworkerInvoiceNumber
string
The coworker invoice number value for this cancelled booking.
CoworkerInvoicePaid
boolean
Whether coworker invoice paid is enabled.
CoworkerInvoiceDraft
boolean
Whether coworker invoice draft is enabled.
CoworkerInvoiceVoid
boolean
Whether coworker invoice void is enabled.
CoworkerInvoiceCreditNote
boolean
Whether coworker invoice credit note is enabled.
CoworkerExtraServiceIds
string
The coworker extra service ids value for this cancelled booking.
CoworkerExtraServicePrice
number
The coworker extra service price value for this cancelled booking.
CoworkerExtraServiceCurrencyCode
string
The coworker extra service currency code value for this cancelled booking.
CoworkerExtraServiceChargePeriod
integer
The coworker extra service charge period value for this cancelled booking.
CoworkerExtraServiceTotalUses
integer
The coworker extra service total uses value for this cancelled booking.
IncludeZoomInvite
boolean
Whether include zoom invite is enabled.
ZoomEventData
string
The zoom event data value for this cancelled booking.
CheckedInAt
string
Date/time value for checked in at.
CancelIfNotPaid
boolean
Whether cancel if not paid is enabled.
CancelIfNotCheckedIn
boolean
Whether cancel if not checked in is enabled.
MaxOccupancy
integer
The max occupancy value for this cancelled booking.
LastMinutePriceAdjustment
number
The last minute price adjustment value for this cancelled booking.
DynamicPriceAdjustment
number
The dynamic price adjustment value for this cancelled booking.
PriceFactorLastMinute
number
The price factor last minute value for this cancelled booking.
PriceFactorDemand
number
The price factor demand value for this cancelled booking.
Office365AdminEventId
string
ID of the office365 admin event associated with this record.
CancellationReason
integer
Reason the booking was cancelled, e.g. NoLongerNeeded, TooExpensive, or NotCheckedIn. See eBookingCancellationReason? enum above.
CancelledBy
string
Name or identifier of the user who cancelled the booking.
CancellationReasonDetails
string
Additional free-text details explaining the cancellation reason.
Price
number
Booking price.
OriginalBookingId
string
ID of the original booking associated with this record.

Code Examples

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
}'

Response

200

Status
integer
HTTP status code. 200 on success.
Message
string
A human-readable message confirming the update.
Value
object
Contains the Id of the updated record.
WasSuccessful
boolean
true if the cancelledbooking was updated successfully.
Errors
array
null on success.
Example Response
{
  "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

Message
string
A summary of the validation error(s), in the format PropertyName: error message.
Value
any
null on validation failure.
Errors
object[]
Array of validation errors.
WasSuccessful
boolean
false when the request fails validation.
Example Response
{
  "Message": "FromTime: is a required field",
  "Value": null,
  "Errors": [
    {
      "AttemptedValue": null,
      "Message": "is a required field",
      "PropertyName": "FromTime"
    }
  ],
  "WasSuccessful": false
}