Ionhour Docs

Workspaces & Teams

Manage multi-tenant workspaces, invite team members, and configure roles and permissions.

Workspaces are the top-level organizational unit in IonHour. Everything — checks, projects, incidents, status pages, alert channels — belongs to a workspace. Each workspace has its own team, plan, and settings.

Creating a Workspace

  1. Click Create Workspace from the workspace switcher or the workspaces page.
  2. Enter a name for the workspace.
  3. Optionally invite team members by email during creation.

You automatically become the Owner of workspaces you create.

Workspace settings page

Roles and Permissions

Every workspace member has a role that determines what they can do.

RoleAccess
OwnerFull control. Can delete the workspace, transfer ownership, and manage all members.
AdminCan manage settings, team members (Member/Viewer only), and all operational features. Cannot modify other Admins or the Owner.
MemberCan create and manage checks, view incidents, and use all monitoring features. Cannot manage team or workspace settings.
ViewerRead-only access. Can view checks, incidents, and dashboards but cannot make changes.

Role Hierarchy

Admins can only change the role of Members and Viewers — they cannot modify other Admins or the Owner. Only the Owner can promote someone to Admin or demote an Admin.

The Owner role cannot be removed. To change the Owner, use the ownership transfer feature.

Inviting Team Members

Sending Invitations

  1. Navigate to Settings > Workspace.
  2. Scroll to the Team section.
  3. Enter one or more email addresses.
  4. Select the role to assign (defaults to Member).
  5. Click Invite.

Each invitee receives an email with a link to accept the invitation. Invitations expire after 7 days.

Invitation Lifecycle

StatusMeaning
PendingInvitation sent, waiting for response
AcceptedUser accepted and joined the workspace
RejectedUser explicitly declined
CanceledAn Owner or Admin revoked the invitation
Expired7 days passed without a response

You can resend a pending invitation (generates a new token and resets the expiry) or cancel it entirely.

Accepting an Invitation

When a user clicks the invitation link:

  1. If they already have a IonHour account, they're prompted to accept or reject.
  2. If they don't have an account, they'll create one first, then accept.
  3. On acceptance, they're added to the workspace with the assigned role and redirected to the workspace dashboard.

If the invitation email doesn't match the signed-in account, the user is prompted to sign in with the correct account.

Managing Members

Changing Roles

  1. Go to Settings > Workspace > Team.
  2. Find the member in the list.
  3. Select a new role from the dropdown.

Role changes take effect immediately. Remember: Admins can only change Members and Viewers. Only the Owner can change Admin roles.

Removing Members

  1. Go to Settings > Workspace > Team.
  2. Click the remove action on the member you want to remove.

Removed members immediately lose access to the workspace. Their historical activity (created checks, incidents, notes) is preserved.

Transferring Ownership

The Owner can transfer workspace ownership to any existing member.

  1. Go to Settings > Workspace > Danger Zone.
  2. Click Transfer Ownership.
  3. Select the new owner from the member list.
  4. Confirm the transfer.

The transfer:

  • Promotes the selected member to Owner.
  • Demotes the current Owner to Admin.
  • Is immediate and irreversible (without another transfer).

Deleting a Workspace

Only the Owner can delete a workspace.

  1. Go to Settings > Workspace > Danger Zone.
  2. Click Delete Workspace.
  3. Confirm the deletion.

Deleting a workspace permanently removes all associated data: projects, checks, incidents, status pages, alert channels, and team memberships. This action cannot be undone.

Workspace Settings

General Settings

SettingDescription
NameThe workspace display name (Owner and Admin can edit)
PlanCurrent subscription plan (Free, Pro, Business)
Dependency Impact AlertsEnable or disable dependency impact propagation for the workspace

Feature Availability by Plan

Some features are gated by workspace plan:

FeatureFreeProBusiness
Team members1MultipleMultiple
Dependency impact alertsLimitedFullFull
Check limitsBasicHigherHighest
Outbound check limitsLimitedMoreMost

Workspace-Scoped Data

All data in IonHour is workspace-scoped. When you switch workspaces, you see a completely separate set of:

  • Projects and checks
  • Incidents
  • Status pages
  • Alert channels
  • Dependencies
  • Deployments

This multi-tenant model ensures complete isolation between workspaces. A user can be a member of multiple workspaces with different roles in each.

User Profile Settings

Some settings apply to your user account across all workspaces:

SettingDescription
TimezoneUsed for all date/time displays
Date formatHow dates are formatted in the UI
Time format12-hour or 24-hour time
Email notificationsGlobal toggle for email alerts

These are configured in Settings > Profile.

Best Practices

  • Use the principle of least privilege. Assign Viewer roles to stakeholders who need visibility but shouldn't modify monitoring. Use Member for engineers who create and manage checks. Reserve Admin for team leads.
  • Create separate workspaces for separate concerns. If you have completely independent products or teams that don't share infrastructure, separate workspaces provide cleaner isolation.
  • Don't share a single workspace across unrelated teams. Workspace-level settings (alert channels, plans, dependency toggles) apply to everyone. Teams with different alerting needs should have their own workspaces.
  • Transfer ownership before the Owner leaves. If the Owner leaves your organization, you'll need Anthropic support to recover the workspace. Transfer ownership proactively.