Docs/Features/Team Management

Team Management

Organize your AI spend by team, control access, and attribute costs to the right people.

Organization Structure

CostLens uses a three-level hierarchy:

Organization

└── Teams (Backend, Frontend, ML/AI...)

└── API Keys (backend-prod, staging...)

└── Members (developers)

Roles

RolePermissions
OWNERFull access. Manage billing, teams, members, and settings.
ADMINManage teams and members. View all analytics. Set budgets.
MEMBERView own usage and team aggregate. Use API keys.

Creating Teams

Teams are created automatically when you sign up. You can rename them or create additional teams from Settings.

  • Each team gets a random name on creation (rename anytime)
  • API keys are scoped to teams
  • Analytics roll up from key → team → organization

Inviting Members

Invite developers by email from Settings → Team. They receive an invite link and join with MEMBER role by default.

  • Invite by email — no account needed upfront
  • Pending invites visible in team settings
  • Admins can promote members or remove them

Per-Developer Attribution

Every API call is attributed to the developer who made it. View spend breakdowns per person in Analytics.

Attribution happens automatically via the API key — no extra code needed.

Team Budgets

Set spending limits at any level:

  • Per API key — daily cost cap on individual keys
  • Per team — aggregate limit across all team keys
  • Organization — total monthly cap (Business plan)

When a budget is hit, CostLens either blocks requests or forces routing to the cheapest model, depending on your configuration.

Slack Notifications

Get team-level alerts in Slack:

  • Budget warnings at 75% and 90%
  • Daily cost summaries per team
  • Anomaly detection (3x above average)
  • Per-key webhook overrides for different channels

Audit Log

All team actions are logged — member invites, role changes, key creation, budget updates. Available to Admins and Owners.