What is a Team?
A team is a named entity that:- Belongs to an organization
- Can have parent and child teams (forming a hierarchy)
- Receives capacity reservations from pools
- Contains workloads
Hierarchy
Teams form a tree structure that mirrors your organization:Why Hierarchies Matter
Capacity Inheritance
Child teams (aka Projects) can use parent capacity when their own is exhausted
Visibility
Managers see aggregate utilization for their entire subtree
Delegation
Team leads manage their subtree without org-wide access
Flexibility
Restructure teams without recreating reservations
Capacity and Workloads
Reservations
Each team can have reservations in one or more capacity pools:Workloads
Workloads are associated with exactly one team via labels:Best Practices
Start shallow, go deep as needed
Start shallow, go deep as needed
Begin with a flat structure (one team per major team). Add hierarchy only when you need finer-grained capacity control.
Use meaningful slugs
Use meaningful slugs
Slugs appear in workload labels and CLI commands. Use short, descriptive slugs like
cv-team instead of computer-vision-research-team-2024.Align with reporting needs
Align with reporting needs
Structure teams to match how you want to see utilization reports. If you report by project, make projects teams.

