1. Builder Docs
  2. Administration
  3. User Management

User Management

This page covers how to invite users, assign roles, and manage workspace settings in the Ema platform.

Accessing User Management

  1. Sign in to the Ema platform.
  2. Navigate to Settings from the main navigation.
  3. Select the Users tab.

The Users page displays all members of your workspace in a table, along with their roles and invitation status.

Inviting Users

Prerequisites

You must hold a role with the Invite Users permission to add new members. At the Workspace level, this includes Workspace Admin and Workspace Manager. See Governance, Access & Permissions for the full permission matrix.

Steps

  1. On the Settings > Users page, click Invite Users.
  2. Enter one or more email addresses. You can:
    • Type an email and press Enter or comma to add it.
    • Paste a comma-separated list of emails.
  3. Select a role for the invited users from the dropdown. Available roles are loaded based on your workspace's tenant-level role catalog.
  4. Click Send Invitations.

Invited users receive an email with a magic login link. The link expires after 15 minutes. If the link is not received, verify:

  • The recipient's email provider is not blocking Ema's emails or routing them to spam.
  • The recipient is not from a geo-blocked country.

Common Invitation Errors

ErrorCauseResolution
Invalid emailThe entered email address does not match a valid format.Correct the email and retry.
Permission deniedYour role does not have the Invite Users permission.Ask a Workspace Admin or Manager to send the invitation.
Invalid emails while pastingOne or more pasted emails are malformed.Remove invalid entries and retry.

Assigning and Changing Roles

Role assignment and modification are available to users with the Change User Permissions permission bit (Workspace Admin, Workspace Manager).

  1. On the Settings > Users page, find the user in the table.
  2. Click the role dropdown next to the user's name.
  3. Select the new role.
  4. Confirm the change.

Role changes take effect immediately. The user does not need to log out and log back in.

Removing Users

Users with the Remove Users permission bit (Workspace Admin, Workspace Manager) can remove members from the workspace.

  1. On the Settings > Users page, find the user in the table.
  2. Click the remove or delete action for that user.
  3. Confirm removal.

Removing a user revokes their access to the workspace and all AI Employees within it. If the user also has direct AI Employee-level or Project-level roles, those must be revoked separately.

Managing AI Employee-Level Access

In addition to workspace-level roles, you can manage access at the individual AI Employee level:

  1. Navigate to the AI Employee's detail page.
  2. Open the user management section (accessible from the AI Employee's settings or sharing options).
  3. Add users and assign AI Employee-level roles (AI Employee Admin, Manager, Builder, or Guest).

Users added at the AI Employee level do not need a workspace-level role beyond Guest (or no workspace role if they are explicitly invited to the AI Employee).

Last updated: Jul 3, 2026