Admin FAQ & Troubleshooting
Quick answers to common platform-administration questions, with pointers to the full guides.
Roles and access
How do I grant or change a user's roles? Go to Admin → Users, open the user, edit their role set, and save. Changes take effect on that user's next API request. See Tenants, Companies & Users.
Why isn't a role change showing in the audit log? Role changes via Admin → Users → Edit Roles currently update the database but do not write an audit-log entry. This is expected behavior at this time.
A new company user has the company_admin role but the 120 RPM company rate limit isn't applying.
The rate limiter's company tier checks for the legacy company role, which does not match
company_admin or company_member. See the role notes in the
Overview.
/admin/usersTenants
I suspended a tenant but its users can still sign in.
Suspension sets the tenant status to suspended as a record-keeping signal. The auth middleware
does not currently hard-block API access on tenant status. See
Tenants, Companies & Users.
No invitation email went out after I created a tenant. No invitation is sent automatically. Users sign up and onboard independently, or you can pre-register them from Admin → Users.
Email and notifications
Emails aren't being delivered.
The live provider is Resend, which requires a valid RESEND_API_KEY on the API server. Without
it, email is silently disabled while the rest of the platform keeps working. Use Admin →
Settings → Email to send a test message and check delivery status. See
Platform Settings.
/admin/settings/emailImports and catalogue
Can I undo a workbook import? Yes — open the committed run and choose Rollback…. Note that profiles are soft-deleted but the skills and certifications it created are permanently removed. See Workbook Imports.
A submitted skill looks like a duplicate. What should I do? In Admin → Catalogue → Submissions, use Map existing (or add an alias) instead of approving a new entry. See Catalogue Administration.
Maintenance
How do I take the platform offline safely? Use Admin → Settings → Maintenance: set the message, toggle maintenance mode on, and apply. Admin access is preserved. Remember to turn it off when you finish.
While enabled, all non-admin users see the maintenance page and cannot use the platform. Confirm the message and timing before applying. See Platform Settings.