Administration
Forte provides tools for managing your project's users, tracking activity, and maintaining security.
User administration is part of Forte's server-side API (forte.projects.*). These operations require FORTE_API_TOKEN and run from your backend — they are project-owner powers, not actions your end users can perform themselves. For the actions end users can perform on their own accounts, see the client-side API.
User States
Every user in your project has one of three states:
| State | Description |
|---|---|
| Active | The user can authenticate and interact with your services normally |
| Suspended | The user is temporarily blocked from authenticating. Existing sessions are invalidated |
| Deleted | The user is permanently removed. All sessions and data are cleaned up |
You can suspend or delete a user from the Users dashboard or API.
In live projects, the hard-delete action is not available. Use the Suspend action to deactivate a user while retaining their record. Permanent, immediate deletion is only available in Sandbox (Test) Mode projects.
User Management Dashboard
The Forte Console provides a user management dashboard where you can:
- View all users in a project with their contact methods and state
- Search and filter users by email, phone number, or state
- Suspend or reactivate users
- View a user's session history and active sessions
- Inspect contact methods and their verification status
Click any user below to view their details and audit trail. Try suspending and reactivating a user to see how state changes are tracked.
Audit Trails
Forte automatically logs user actions for security monitoring and compliance. Every significant event is recorded with a timestamp, user ID, and action type.
Tracked events include:
- User created
- User suspended
- User deleted
- Contact method added
- Contact method removed
- Contact method verification code sent
- Contact method verified
- User login
- User logout
Audit logs are accessible from the Console dashboard and can be filtered by user, action type, or time range.
Sandbox-Only Capabilities
Sandbox (Test) Mode projects unlock two additional user management capabilities that are not available in live projects:
- Hard-delete users — Permanently and immediately remove a user and all associated data, with no possibility of recovery. Useful for resetting state between test runs.
- Override contact methods and verification — Directly set a user's email or phone number and mark it as verified without sending a real verification code. Useful for fixture setup and automated tests.
Next Steps
- Set up Authentication methods for your users
- Learn about Contact Methods and verification
- Understand Sessions and token management