Teams

Teams let you group users so that usage, cost, and analytics data can be viewed at the team level. Once users belong to a team, all reporting pages — Usage, Analytics, Adoption — can filter and break down data by team.

How teams work

A team is a named group of users within your organization. Each team has:

  • A name and a color-coded avatar (auto-generated from the team initials)
  • A member list with roles
  • A member count shown alongside the team in listings

Teams appear as filter options on the Usage and Analytics pages. They also appear in the Usage breakdown table, where each user row shows a team badge.

Automatic attribution

Some teams are attributed automatically — Kimchi assigns users to these teams based on provisioning data (e.g., SSO group membership or API key ownership). Automatically attributed teams are labeled as such in the team detail view. You can still add or remove members manually from these teams.

Manual teams

You can also create teams manually for any grouping that doesn't map to your provisioning structure — for example, cross-functional project teams, temporary working groups, or cost centers.

Create a team

  1. Navigate to Account > Teams page in the Kimchi console.
  2. Click + New team.
  3. Enter a team name.
  4. Add members
  5. Click Create.

The team appears in the team list immediately. You can always add members to an existing team later.

Add members to a team

  1. Select the team from the team list on the left.
  2. Click Add member in the team detail view on the right.
  3. Search for users by name or email and select them.
  4. Confirm the addition.

New members appear in the team's member list, and their usage data is immediately reflected in team-level reporting.

Remove a member from a team

  1. Select the team from the team list.
  2. Find the member in the member list.
  3. Click the X button next to their name.

Removing a member does not delete their historical usage data from team reports — it only stops future requests from being attributed to that team.

Member roles

Each team member has one of three roles:

RolePermissions
ViewerCan see team data in reporting pages. Cannot modify team membership.
MemberCan see team data and participate in team workflows.
OwnerFull control over the team — can add/remove members and change roles.

Roles are assigned when adding a member and can be changed by an Owner at any time.

How teams appear in reports

Once you've organized users into teams, team-level data appears across the console:

  • Usage (by team): aggregated request count, tokens, and cost per team. A stacked bar chart shows team activity over time. See Usage.
  • Analytics: the Usage by team section shows how API traffic is distributed across teams. See Analytics.
  • Filters: select specific teams in the filter bar on Usage and Analytics pages to isolate their data.

See also