Identity: User and Tenant Management in Flametree
Learn how to register accounts, manage users, assign roles, and configure tenant settings in the Flametree Portal.
Prerequisites
- Access to the Flametree Portal
- Valid email address for registration
- For user management: Tenant Admin role required
Registration and Initial Setup
How to Register
- Go to the Flametree portal
- Click the Sign Up button
- Fill out the registration form:
- Email — enter a valid email address
- Password — create and enter a secure password
- Alternatively, register using a Google account
- Follow the registration wizard:
- Select a data storage region
- Upon completion, your first account (tenant) is automatically created
💡 Note: After registration, you automatically receive Tenant Admin privileges for your new tenant.
User Management
Accessing User Management
After registration, you gain access to the Identity section to manage users:
- In the left-side menu, go to Identity → Users
- The Users tab lists all users in your account
- By default, there will be only one user — yourself
Adding New Users
- Go to Identity → Users and click Add User
- Fill out the form:
- Name — user's name
- Email — valid email address
- Password — set a password
- Tenant — select the tenant (usually only one available)
- Assign a role (see role descriptions below)
⚠️ Warning: Only Tenant Admins can add or remove users.
User Roles and Permissions
Every user in Flametree is assigned a role that defines their level of access. The platform supports three standard roles:
| Role | Description | Permissions |
|---|---|---|
| Tenant Admin | Full administrative access | • Create, edit, delete AI agents • Manage knowledge bases and integrations • Add/remove users and change roles • Manage billing and subscriptions • Access AI agent/session logs • Configure integrations (channels, LLM, STT/TTS) |
| Tenant User | Limited access for testing | • Access to Playground only • Test AI agents and review dialogues • No access to create/delete agents or manage users |
| Tenant Viewer | Read-only access | • View agents and their configurations • View knowledge bases and session logs • Cannot create, edit, or run AI agents • Cannot modify knowledge bases or integrations |
Managing User Roles
Who can assign roles:
- Only users with Tenant Admin rights
How to change a user's role:
- Go to Identity → Users
- Find the user in the list
- Click Edit
- Select the new role
- Save changes
💡 Note: Role changes take effect immediately after saving.
Tenant Management
Users with the Tenant Admin role can manage the organization (Tenant) created during registration.
Accessing Tenant Settings
To start configuring, go to: Home → Identity → Tenant
The Tenant section offers:
- Viewing a list of available tenants (by default, only one is created at registration)
- Copying the tenant's API key (used for "private" API methods)
- Editing tenant details
Editing Tenant Information
- Go to Identity → Tenant and click Edit Tenant
- Fill in the following fields:
- Name – Company name (tenant)
- Description – Description of the tenant
- Phone – Company contact number
- Billing email – Company billing email
- Country – Select from the dropdown list
- Street – Optional company mailing address
- ZIP code – Postal code
- Website – Company website
Public Tenant (Library)
If your account is registered as a Flametree partner, you gain access to the Public Tenant (Library):
- The public tenant contains demo agents that can be copied and used in your own projects
- Access the public tenant via the dropdown menu at the bottom of the sidebar
Working with Demo Agents
What you can do with demo agents:
- Export AI agents from the public tenant
- Import AI agents into your working tenant
- Edit and run AI agents tailored to your use case
Best Practices
- Role Assignment: Start new team members with Tenant User role for testing, then upgrade to Tenant Admin only when necessary
- Security: Regularly review user access and remove inactive users
- Documentation: Keep tenant information up-to-date for billing and support purposes
- API Keys: Protect your tenant's API key and regenerate if compromised
Common Issues & Solutions
New user cannot access certain features
Check the user's role assignment. Only Tenant Admins have full access to all features. Tenant Users can only access the Playground, and Tenant Viewers have read-only access.
Cannot add new users
Ensure you have Tenant Admin privileges. Only Tenant Admins can add or remove users from the system.
Lost access to tenant settings
Contact your organization's Tenant Admin or create a new account if you're the sole user. At least one Tenant Admin must exist per tenant.
FAQ
How to create a new user in the system?
There are two ways to create a new user:
-
Via Self-Registration
- Go to the system login screen
- Click the Registration button
- Fill out the registration form (name, email, password)
- The system will automatically create a new tenant and a user with the Tenant Admin role
-
Via manual addition (if you are already a Tenant Admin)
- Log into the system using your account
- Open the menu and go to Identity → Users
- Click Add User
- Fill in the required fields (Name, Email, Password, Tenant, Role)
📋 Important Notes:
- Only users with the Tenant Admin role can add new users within their account
- Self-registration creates a single user with the Tenant Admin role
- Each user is assigned to one tenant only
What are the different user roles and their permissions?
| Role | Access Rights |
|---|---|
| Tenant Admin | Full administrator rights: can create/delete users, configure AI agents, integrations, and billing |
| Tenant User | Access only to the Playground section: can test AI agents but cannot change settings |
| Tenant Viewer | Read-only: can view AI agents and sessions but cannot make any changes |
How to create a new user in the system?
There are two ways to create a new user:
- Via Self-Registration
- Go to the system login screen.
- Click the Registration button.
- Fill out the registration form (name, email, password).
- The system will automatically create a new tenant and a user with the Tenant Admin role.
- Via manual addition (if you are already a Tenant Admin)
- Log into the system using your account.
- Open the menu and go to Identity → Users.
- Click Add User.
- Fill in the following fields:
- Name — user's name
- Email — valid email address
- Password — login password
- Tenant — usually there will be only one option: your current tenant
- Role — choose one of the available roles:
| Role | Access Rights |
|---|---|
| Tenant Admin | Full administrator rights: can create/delete users, configure AI agents, integrations, and billing. |
| Tenant User | Access only to the Playground section: can test AI agents but cannot change settings. |
| Tenant Viewer | Read-only: can view AI agents and sessions but cannot make any changes. |
📋 Important Notes:
- Only users with the Tenant Admin role can add new users within their account.
- Self-registration creates a single user with the Tenant Admin role — you can use this account immediately or add additional users.
- Each user is assigned to one tenant only.
Quick steps to add a new user:
- Open Identity → Users.
- Click Add User.
- Enter name, email, and password.
- Select a role.
- Save the changes.
The new user will immediately appear in the list and will be able to log into the system.