Skip to main content

Physical Spaces

A Physical Space in ZenEdge represents a real-world room or pod with attached IoT devices.

Physical Space Properties​

PropertyDescription
idUnique identifier
nameDisplay name
organization_idOwning organization
adaptersList of attached device adapters
virtual_mappingLink to ZenCore Meeting Space

CRUD Operations​

List Physical Spaces​

GET /api/v1/physical-spaces?organization_id=org-123
x-api-key: <api-key>

Create Physical Space​

POST /api/v1/physical-spaces
x-api-key: <api-key>
Content-Type: application/json

{
  "name": "Meeting Room 101",
  "organization_id": "org-123"
}

Virtual Space Mapping​

Physical spaces are linked to ZenCore virtual meeting spaces via mappings:

POST /api/v1/physical-spaces/:id/mapping
x-api-key: <api-key>
Content-Type: application/json

{
  "virtual_meeting_space_id": "ms-abc123",
  "start_at": "2025-01-01T00:00:00Z",
  "end_at": "2025-12-31T23:59:59Z"
}

This mapping enables:

  • Booking events from ZenCore to trigger device actions in ZenEdge
  • Magic link generation for the correct physical space
  • Device health status visible in the admin dashboard

Next Steps​