Update Booking

PUT

api

spaces

bookings

Update Booking

curl --request PUT \
  --url https://spaces.nexudus.com/api/spaces/bookings \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Id": 123,
  "ResourceId": 123,
  "FromTime": "<string>",
  "ToTime": "<string>",
  "Repeats": 123,
  "WhichBookingsToUpdate": 123
}
'

import requests

url = "https://spaces.nexudus.com/api/spaces/bookings"

payload = {
    "Id": 123,
    "ResourceId": 123,
    "FromTime": "<string>",
    "ToTime": "<string>",
    "Repeats": 123,
    "WhichBookingsToUpdate": 123
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    Id: 123,
    ResourceId: 123,
    FromTime: '<string>',
    ToTime: '<string>',
    Repeats: 123,
    WhichBookingsToUpdate: 123
  })
};

fetch('https://spaces.nexudus.com/api/spaces/bookings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

Updates an existing Booking 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 Booking-Edit role.

Enums

eBookingRepeatCycle — Repeats values

Value	Name
1	Daily
2	Weekly
3	Monthly
4	Yearly
5	FirstOfMonth
6	SecondOfMonth
7	ThirdOfMonth
8	LastOfMonth
9	FourthOfMonth

eRepeatedBookingUpdateAction — WhichBookingsToUpdate values

Value	Name
1	UpdateThisBookingOnly
2	UpdateFutureBookingsOnly
3	UpdateAllBookings
4	UpdateNotChargedBookings
5	DeleteAllBookings
6	DeleteBookingsAfterThis
7	DeleteNotChargedBookings
8	RevertAllCharges

Request Body

Required Fields

integer

required

The Id of the Booking record to update.

integer

required

ID of the resource being reserved; it determines the booking location and availability rules..

string

required

Booking start date and time in UTC..

string

required

Booking end date and time in UTC; it must be after FromTime..

integer

required

Recurrence cycle: Daily, Weekly, Monthly, Yearly, FirstOfMonth, SecondOfMonth, ThirdOfMonth, FourthOfMonth, or LastOfMonth..

integer

required

For a recurring booking update, selects whether to update this booking, future bookings, all bookings, not-charged bookings, or perform the corresponding delete or charge-reversal action..

Optional Fields

integer

Optional ID of the floor-plan unit assigned within the selected resource. The unit must be connected to this resource.

integer

Optional ID of the customer this booking is for..

integer

Optional ID of the rate used to price this booking. Set it only to a rate linked to the selected resource’s ResourceType. When no rate is provided, the system calculates an applicable rate automatically..

string

Customer-facing notes for the booking..

string

Internal staff notes recorded when the booking is created..

boolean

Whether to charge the booking immediately when it is created or updated..

boolean

Whether to generate an invoice for the booking immediately..

boolean

Whether the selected customer receives the booking charge. When false, the customer’s team-paying member, if any, is the billing party..

boolean

Whether to prevent available customer booking credit from being used for this booking..

string

Optional customer purchase-order reference for the booking..

string

Optional discount code applied when the booking price is calculated..

string

System-maintained UTC timestamp of the last booking notification..

string

Internal Google Calendar identifier maintained by calendar synchronization..

string

Internal Google Calendar event identifier maintained by calendar synchronization..

string

Internal Microsoft 365 calendar event identifier maintained by synchronization..

string

Internal public Google Calendar event identifier maintained by synchronization..

boolean

Whether the booking is tentative and still requires confirmation. Customer bookings for resources requiring confirmation are created as tentative; administrators can create tentative bookings for any resource..

string

System snapshot of the customer’s team memberships when the booking was made..

string

System snapshot of the customer’s plan when the booking was made..

string

System-generated identifier linking all bookings in the same recurrence series; use it to find and update all bookings in that series..

boolean

Whether to create a recurring series from this booking..

integer

Optional positive recurrence interval; for example, 2 with Weekly repeats every two weeks..

string

Optional final UTC date and time for creating occurrences in the recurrence series..

boolean

Whether a weekly recurring booking includes Mondays..

boolean

Whether a weekly recurring booking includes Tuesdays..

boolean

Whether a weekly recurring booking includes Wednesdays..

boolean

Whether a weekly recurring booking includes Thursdays..

boolean

Whether a weekly recurring booking includes Fridays..

boolean

Whether a weekly recurring booking includes Saturdays..

boolean

Whether a weekly recurring booking includes Sundays..

boolean

System flag showing whether the standard booking reminder has been sent..

boolean

System flag showing whether the standard booking notification has been sent..

boolean

System flag showing whether an MRM reminder has been sent..

number

Optional total price override for this booking, before normal rate calculation..

integer

Internal Kisi access-control key identifier for this booking..

string

Internal scheduled-job identifier for the booking start..

string

Internal scheduled-job identifier for the booking end..

boolean

Internal billing-processing state for this booking..

string

System-maintained local-time representation of FromTime..

string

System-maintained local-time representation of ToTime..

string

System-maintained local-time representation of InvoiceDate..

number

System-calculated price from the customer’s applicable rate entitlement..

boolean

Whether to include a Zoom meeting invitation for this booking..

string

Internal Zoom event payload maintained by the integration..

string

Internal Microsoft 365 administrator calendar event identifier maintained by synchronization..

string

UTC date and time when the customer checked in for this booking..

string

UTC date and time when the customer checked out from this booking..

Children

object[]

Products to include with this booking

Show child attributes

integer

required

ID of the product linked to this record.

integer

required

The number of units of this product to include in the booking.

boolean

Whether to invoice this product based on the booking duration in minutes.

object[]

Visitors to add to this booking

Show child attributes

string

Display value for Visitor.FullName..

string

Display value for Visitor.Email..

Code Examples

curl -X PUT \
  "https://spaces.nexudus.com/api/spaces/bookings" \
  -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,
    "Id": 87654321,
    "BookingProducts": [
        {
            "ProductId": 0,
            "Quantity": 0,
            "InvoiceInMinutes": false
        }
    ],
    "BookingVisitors": [
        {
            "VisitorFullName": null,
            "VisitorEmail": null
        }
    ]
}'

const response = await fetch(
  'https://spaces.nexudus.com/api/spaces/bookings',
  {
    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,
      Id: 87654321,
      BookingProducts: [object Object],
      BookingVisitors: [object Object]
    })
  }
);

const data = await response.json();

import requests

response = requests.put(
    'https://spaces.nexudus.com/api/spaces/bookings',
    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,
        'Id': 87654321,
        'BookingProducts': [object Object],
        'BookingVisitors': [object Object]
    }
)

data = response.json()

Response

200

integer

HTTP status code. 200 on success.

string

A human-readable message confirming the update.

object

Contains the Id of the updated record.

boolean

true if the booking was updated successfully.

array

null on success.

Example Response

{
  "Status": 200,
  "Message": "Booking 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

string

A summary of the validation error(s), in the format PropertyName: error message.

any

null on validation failure.

object[]

Array of validation errors.

Show child attributes

any

The value that was submitted for the field, or null if missing.

string

The validation error message.

string

The name of the property that failed validation.

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
}

Update Booking

curl --request PUT \
  --url https://spaces.nexudus.com/api/spaces/bookings \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Id": 123,
  "ResourceId": 123,
  "FromTime": "<string>",
  "ToTime": "<string>",
  "Repeats": 123,
  "WhichBookingsToUpdate": 123
}
'

import requests

url = "https://spaces.nexudus.com/api/spaces/bookings"

payload = {
    "Id": 123,
    "ResourceId": 123,
    "FromTime": "<string>",
    "ToTime": "<string>",
    "Repeats": 123,
    "WhichBookingsToUpdate": 123
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    Id: 123,
    ResourceId: 123,
    FromTime: '<string>',
    ToTime: '<string>',
    Repeats: 123,
    WhichBookingsToUpdate: 123
  })
};

fetch('https://spaces.nexudus.com/api/spaces/bookings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

Overview

Apps & Marketplace

Billing

Collaboration

Community

Content

CRM

Security

Spaces

Support

System

Authentication

Enums

Request Body

Required Fields

Optional Fields

Children

Code Examples

Response

200

400

​Authentication

​Enums

​Request Body

​Required Fields

​Optional Fields

​Children

​Code Examples

​Response

​200

​400

Authentication

Enums

Request Body

Required Fields

Optional Fields

Children

Code Examples

Response

200

400