Skip to main content

FAQ

General​

What is SpaceOS? SpaceOS is ZenSpace's multi-tenant platform for managing physical spaces (meeting rooms, offices, coworking) with bookings, payments, IoT device automation, and meeting room displays.

How many services make up SpaceOS? SpaceOS is composed of 8 services: ZenCore, ZenEdge, Scheduler, Realtime Service, IoT Adapter, Admin Dashboard, Booking SPA, and Meeting Room Display.

Technical​

What API format does SpaceOS use? REST APIs with JSON. All responses use a consistent envelope format with status, success, data, and optional meta fields.

How is authentication handled? Users authenticate via OTP (email) → JWT. System integrations use API keys (x-api-key). Organization-scoped integrations use Org API keys (x-org-api-key).

What IoT devices are supported? UniFi (doors, Wi-Fi), TTLock, RemoteLock, and Seam. Any device can be integrated by implementing the adapter protocol.

How do on-premise devices connect? Via Tailscale mesh VPN. The IoT Adapter runs on a Raspberry Pi on the customer's network and connects to ZenEdge in the cloud through a WireGuard tunnel.

Bookings​

Can bookings be created without authentication? Yes. Public booking endpoints allow unauthenticated booking creation. Authentication is required for admin operations.

How does the booking state machine work? Bookings transition through states: pending → confirmed → active → completed (or cancelled). The Scheduler service manages time-based transitions via BullMQ delayed jobs.

Does SpaceOS support calendar integration? Yes. Two-way sync with Google Calendar and Microsoft 365/Outlook. One-way import via iCal/CalDAV feeds.

Next Steps​