docs.zenspace.io
  1. Booking
docs.zenspace.io
  • 🧭 Introduction
  • 🧱 System Components
  • 🧰 Tech Stack
  • 🏗️ System Architecture
  • 🌐 Deployment Architecture
  • 🗄️ Database Design Documentation
  • API Endpoints
    • RaspberryPi
      • Heartbeat API
      • Retrieve all active sensors and device permissions
      • Control a device (e.g., turn on/off, adjust intensity)
      • Enable or disable a device
      • Register a meeting space ID and retrieve network details
    • Meeting Space
      • Schedule meeting space state
      • Get meeting spaces by customer
      • Get meeting space state by ID
      • Get meeting space state by device ID
      • Disable meeting space state
      • Send meeting space state by meeting space ID
      • Store meeting space availability
      • Create Google Calendar
    • Device Management
      • Create device
      • Create device sensors
      • Create or update admin unlock codes
      • Upload meeting space screenshot
    • Authentication
      • Create authorization token
    • Messaging
      • Send message to Android device
    • Booking
      • Send meeting space state by booking ID
        GET
      • Create or update booking
        POST
  1. Booking

Create or update booking

POST
/meetingspace/booking
Booking
Last modified:2025-05-29 13:03:16
x-usage:admin
Create, update, or cancel booking. For updates, include the booking ID.
For cancellations, set is_active to false.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/meetingspace/booking' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "start_datetime": "2025-02-24T15:00:00-08:00",
    "end_datetime": "2025-02-24T15:30:00-08:00",
    "meeting_space_id": "0a8c781d-bd46-4615-8f6f-bd329a55eb4d",
    "attendees": [
        {
            "name": "string",
            "email": "user@example.com",
            "phone": "string"
        }
    ],
    "created_by_name": "string",
    "created_by_email": "user@example.com",
    "created_by_phone_no": "string",
    "is_active": true,
    "unlock_key": "string",
    "external_id": "string"
}'

Request

Body Params application/json
id
string <uuid>
optional
Required only for update and cancel booking
start_datetime
string <date-time>
required
Example:
2025-02-24T15:00:00-08:00
end_datetime
string <date-time>
required
Example:
2025-02-24T15:30:00-08:00
meeting_space_id
string <uuid>
required
ZenSpace meeting space ID
attendees
array [object {3}] 
optional
name
string 
optional
email
string <email>
optional
phone
string 
optional
created_by_name
string 
optional
created_by_email
string <email>
optional
created_by_phone_no
string 
optional
is_active
boolean 
required
Set to false to cancel the booking
unlock_key
string 
optional
Optional, automatically generated if not provided
external_id
string 
optional
Third party external ID used to update and cancel booking
Examples

Responses

🟢200OK
Booking processed successfully
This response does not have a body.
Previous
Send meeting space state by booking ID
Built with