User management & invitations

Purpose

User Management is the administrator-facing roster for organization members. It complements the Drivers actor view (Drivers & vendors) which targets day-to-day fleet operations.

Who uses it: Organization admins and delegated user administrators.

Prerequisites

• Route access requires user view/list permissions (view_user, list_user) under organization scope for /dashboard/setting/user-management.
• Individual buttons (edit, deactivate, invite) also check specific permission codes via CanI — if a button is hidden, your role lacks that capability.

Navigation

• Sidebar → Setting → User Management (/dashboard/setting/user-management).
• Invited users tab or route: /dashboard/setting/user-management/invited-users.

Users list

1. Use Search and filters (scope, status, access level, role) — filters sync to URL query parameters for sharing.
2. Paginate through results.
3. Row actions may include edit, activation toggles, or related dialogs depending on CanI wrappers.

Expected results: Data comes from api.OrgUsers.get; invitation tools use api.OrgInvitations.

Invited users

1. Open Invited users.
2. Review pending invitations with pagination and search.
3. Resend or Delete invitations when actions appear — backed by OrgInvitations mutations with toast feedback.

User detail

Navigate to /dashboard/setting/user-management/$userId for the focused user screen when linked from the roster.

Troubleshooting

• Failed to load users: Retry; verify organization context and API health.
• Action unavailable: Compare required permission codes with your role (Permissions).

Related

• Roles & permissions
• Authentication — invitation acceptance flow for new users.