Skip to main content
The Teams page lists all organizational teams and provides create/edit/archive dialogs. It is served at route /hr/teams.

​
Overview

The page uses useTeamList to fetch teams and useTeamMutation (createTeam, updateTeam) for write operations. A search input filters teams by name. Clicking a team card opens an edit dialog; clicking the archive icon opens an archive confirmation dialog. Team cards display name, description, active status, and team lead. Permission: HR_PERMISSIONS.TEAMS_VIEW (hr.teams.view) — RequirePermission guard in hr.tsx.

​
Who it’s for

Permission: hr.teams.view — required by RequirePermission guard in hr.tsx.

​
Before you start

  • None required; the page loads existing teams on first visit.

​
Steps

View and search teams
  1. Navigate to HR > Teams or go to /hr/teams.
  2. Use the Search input to filter teams by name.
Create a team
  1. Click New Team (or equivalent action button).
  2. Enter team name, optional description, team lead, and active status.
  3. Save to create the team.
Edit a team
  1. Click a team card to open the edit dialog.
  2. Modify fields and save.
Archive a team
  1. Click the archive icon on a team card.
  2. Confirm the archive action in the confirmation dialog.

​
Key concepts

Human Resources

Human Resources core overview.

Governance & parity

This page documents shipped product behavior. It is not medical, legal, or billing advice. Verify against your organization’s policies and applicable regulations before using it for clinical, compliance, or billing decisions. Protected health information (PHI) shown in the product is governed by your tenant’s access controls and is never exposed in this documentation.
  • src/routes/hr.tsx
  • src/cores/hr/pages/Teams.tsx
  • src/cores/hr/hooks/employees/useTeamList.ts
  • src/cores/hr/hooks/employees/useTeamMutation.ts