Reference
13.1 Operating-Mode Enum
| Value | Meaning |
|---|---|
| zenspace | ZenSpace owns the booking lifecycle (public booking app works). |
| hybrid | ZenSpace owns the lifecycle but mirrors to a third party too. |
| third_party | External calendar owns the lifecycle (this guide). |
13.2 Connection-Status Enum
| Value | Meaning |
|---|---|
| pending | Awaiting admin action. |
| approved | Active. Booking events flow. |
| declined | Terminal. Submit a fresh request to try again. |
| suspended | Was approved, currently paused. Booking events stop. |
13.3 Third-Party-Mode Wire Values
| Value | Use for |
|---|---|
| Google Calendar | Google Calendar / Workspace |
| Outlook Calendar | Outlook.com / personal Outlook |
| Microsoft Outlook | Microsoft 365 / Exchange |
| Apple Calendar | iCloud Calendar |
| Other | Anything else |
13.4 Booking-Source Enum
Values: web, mobile, api, admin, walk_in, external. Use external for bridge-created bookings.
13.5 Booking-Status and Payment-Status Values
Booking status: pending, confirmed, in_progress, ended, cancelled, no_show
Payment status: pending, paid, failed, cancelled, refunded, partial
For third_party bookings created via API: status=confirmed, payment_status=paid at creation time.
14. Getting Help
-
Swagger UI is available at /api/docs/third-party on the base URL — live reference for every field.
-
Implementation patterns (Pattern A: in-process, B: low-code, C: standalone) are in OPERATING_MODE_THIRD_PARTY.md.
-
Bugs or questions: contact your ZenSpace engineering contact. Include connection_id, booking_id, request body, and full error response in any report.