Skip to main content

Organizations

Organizations are the tenant root in SpaceOS. All spaces, users, bookings, and settings belong to an organization.

List Organizations

GET /api/v1/organizations
Authorization: Bearer <jwt>

Get Organization by Slug (Public)

GET /api/v1/organizations/by-slug/:slug

No authentication required. Used by public booking pages.

Create Organization

POST /api/v1/organizations
Authorization: Bearer <jwt>
Content-Type: application/json

{
"name": "My Workspace",
"slug": "my-workspace",
"timezone": "America/New_York"
}

Update Organization

PATCH /api/v1/organizations/:id
Authorization: Bearer <jwt>
Content-Type: application/json

{
"name": "Updated Workspace Name",
"settings": { }
}

Organization Settings

Organizations have configurable settings including:

  • Default timezone
  • Booking access retry policy
  • Notification preferences
  • Branding (logo, colors)
  • Payment configuration

Next Steps

  • Spaces — Manage space groups and meeting spaces
  • Users & Roles — Manage organization members