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 linked to this record.

string

required

Booking start time.

string

required

Booking end time.

integer

required

Repeat cycle. Create-only.

integer

required

Action to apply when updating or deleting bookings in a repeated series. This is the only field that can modify a series after creation.

Optional Fields

integer

ID of the floor plan desk linked to this record.

integer

ID of the coworker linked to this record.

integer

ID of the extra service linked to this record.

string

Optional notes or comments about this booking.

string

Internal notes.

boolean

Charge immediately.

boolean

Invoice immediately.

boolean

Charge the booking to the customer making it rather than their paying member (if any).

boolean

Do not use booking credit.

string

Purchase order.

string

Discount code.

string

Date/time value for last notification time.

string

ID of the google calendar associated with this record.

string

ID of the google event associated with this record.

string

ID of the office365 event associated with this record.

string

ID of the public google event associated with this record.

boolean

Tentative booking. Must be approved by an administrator before confirmed or charged. Tentative bookings still block the calendar.

string

Teams at the time of booking.

string

Tariff at the time of booking.

string

ID of the repeat series unique associated with this record.

boolean

Create a repeating booking series. Create-only: once created, only WhichBookingsToUpdate can be used to update the series. No new bookings can be added to the series.

integer

Repeat every N periods. Create-only.

string

Repeat until date. Create-only.

boolean

Repeat on Mondays. Create-only.

boolean

Repeat on Tuesdays. Create-only.

boolean

Repeat on Wednesdays. Create-only.

boolean

Repeat on Thursdays. Create-only.

boolean

Repeat on Fridays. Create-only.

boolean

Repeat on Saturdays. Create-only.

boolean

Repeat on Sundays. Create-only.

boolean

Whether reminded is enabled.

boolean

Whether mrm reminded is enabled.

number

Admin-set fixed price for the booking, regardless of what extra service (rate) is associated with it.

integer

ID of the kisi key associated with this record.

string

ID of the start scheduled job associated with this record.

string

ID of the end scheduled job associated with this record.

boolean

Whether billed is enabled.

string

Date/time value for from time local.

string

Date/time value for to time local.

string

Date/time value for invoice date local.

number

The coworker extra service price value for this booking.

boolean

Include Zoom invite.

string

The zoom event data value for this booking.

string

ID of the office365 admin event associated with this record.

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

Full name of the visitor. Read-only, resolved from the linked Visitor record..

string

Email address of the visitor. Read-only, resolved from the linked Visitor record..

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
}

Delete BookingDelete an existing Booking record by its Id.

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