> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synheart.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Organizations & tenants
> Create and manage the organization and tenant workspaces that hold your projects, members, and billing on the Synheart Platform
Organizations and tenants are the two outermost layers of the [resource hierarchy](/platform/overview#the-hierarchy). An **organization** is your company account: it owns billing, members, and every resource below it. A **tenant** is an isolated workspace inside that organization (a department, client, environment, or business unit) where [projects](/platform/projects) actually live.
This page covers creating and switching organizations, configuring organization settings, and managing tenants. For people and permissions, see [Members & roles](/platform/members-and-roles).
The platform is **invite-only** today. [Request access](https://synheart.ai/work-with-us) before continuing.
## At a glance
```text theme={null}
Organization (billing, members, settings)
└── Tenant (isolated workspace, environment)
└── Project (apps, wearables, sessions)
```
| Surface | Purpose |
| ------------------------- | ------------------------------------------ |
| Organization switcher | Switch between organizations you belong to |
| **Organizations** | List your orgs and pending invitations |
| **Organization settings** | Name, slug, description, SSO, and deletion |
| Tenant switcher | Switch the active tenant workspace |
| **Tenants** | Create and manage tenant workspaces |
Most project-scoped pages (wearables, sessions, API keys) need both a valid **organization** and **tenant** selected. If a list is empty, confirm both switchers first.
***
## Organizations
### Switch organizations
Use the **organization switcher** at the top of the left sidebar. Each row shows the organization name and your role in it: **Owner**, **Admin**, or **Member**.
Switching organizations changes your active org context, **clears the current tenant selection**, and reloads org-scoped data. Always confirm you are in the right org before generating keys, inviting people, or registering apps.
### Browse organizations and invitations
Open **Organizations** from the sidebar to see two tabs:
* **My Organizations**: every org you belong to, each card showing your role, a description, and stats (`{n} members · {n} projects · {n} apps`).
* **All Organizations**: reserved for a future directory view.
Pending invitations appear in a **Pending Invitations** section with **View** and **Accept** actions. Accepting takes you straight into the organization. See [Members & roles → Accept an invitation](/platform/members-and-roles#accept-an-invitation).
### Create an organization
First-time users land in onboarding; existing users can create another org from the switcher (**Create Organization**) or from the Organizations page.
The setup wizard walks through:
1. **Create**: **Organization Name** and an optional **Description**.
2. **Plan**: pick a tier (Free, Pro, Synheart Plus, Research, or Enterprise). You can change this later in [Billing & usage](/platform/billing). On-device inference is always free.
3. **Team**: optionally invite teammates now, or **Skip for now**.
On completion you land on **Projects**.
During **early access**, self-service organization creation may be disabled. If you see an early-access notice, contact Synheart to provision additional organizations.
### Organization settings
Open **Organization settings** from the sidebar. The page covers name, slug, and description. Subscription and usage are under **Admin → Billing & Usage**; people are under **Members**.
#### General settings
Your organization has three core identity fields:
* **Organization Name**: the display name shown across the dashboard. Click **Edit Details** to update it.
* **Slug**: a URL-safe identifier assigned at creation, shown in monospace. This is read-only after setup.
* **Description**: an optional free-form summary. Edit it alongside the name via **Edit Details**, then **Save Changes**.
#### Authentication (SSO)
Organizations with a claimed domain can enable single sign-on. Org owners and admins can manage SSO from this section:
* **Claimed domain(s)**: the email domains tied to this org.
* **Google Workspace SSO**: click **Enable** to let members sign in with their Google Workspace accounts. Once enabled, the card shows an **Enabled** badge.
#### Delete an organization
Org owners can permanently remove the organization from the danger zone at the bottom of settings.
Deleting an organization is permanent. All projects, apps, and data associated with this organization will be permanently removed. You must type **DELETE** to confirm before **Delete Permanently** is enabled.
***
## Tenants
Tenants are workspaces inside an organization. Each tenant isolates its projects, members, and configuration from other tenants, for example a `production` tenant separated from a `research-lab` tenant.
### Switch tenants
Use the **tenant switcher** near the bottom of the sidebar. Each row shows the tenant name and your role in it. The selected organization and tenant together scope all resources in the dashboard.
### Manage tenants
Open **Tenants** from the sidebar. The page lets you create and manage workspaces, configure environments, and control who can access each tenant's projects.
Four summary cards count tenants by environment: **Total tenants**, **Production**, **Staging**, and **Development**. Each tenant card shows its name, description, member count, project count, an environment badge, and your role. Use the **Search tenants** box or the **All environments** filter to narrow the list. The **Tenant actions** menu offers **Manage members**, **Add people**, **Edit tenant**, and **Delete tenant**.
### Create a tenant
Click **Create tenant** and complete the form:
| Field | Description |
| --------------- | ----------------------------------------------------- |
| **Tenant name** | Workspace name, e.g. `wellness-pilot`, `research-lab` |
| **Description** | Optional summary |
| **Environment** | `development`, `staging`, or `production` |
The tenant is created under the currently selected organization. Edit these fields later with **Edit tenant**.
### Add people to a tenant
Use the **Add people** action to invite someone to this tenant by email. See [Members & roles → Tenant members](/platform/members-and-roles#tenant-members) for roles and the full invitation flow.
### Delete a tenant
The **Delete tenant** action permanently removes the tenant.
This will permanently delete the tenant and cannot be undone. Projects and data inside the tenant are removed with it.
***
## Troubleshooting
| Symptom | Likely cause | What to check |
| ----------------------------------- | ----------------------------------- | ----------------------------------------------------- |
| Lists empty after switching org | Tenant selection was cleared | Pick a tenant in the sidebar switcher |
| **Could not load tenants** | Your account lacks workspace access | Ask an org admin to invite you to a tenant or project |
| **No tenant yet** (org owner/admin) | Org has no tenants | **Create your first tenant**, then retry |
| Can't edit or delete the org | Insufficient permissions | Contact the organization owner to adjust your role |
***
## Next
Invite people, assign roles, and manage invitations across orgs, tenants, and projects.
Create projects inside a tenant and organize your apps and sessions.
Choose a plan, monitor metered usage, and manage your subscription.
Sign in, register apps, and request the access your integration needs.