diff --git a/docs/my-website/docs/proxy/user_management_heirarchy.md b/docs/my-website/docs/proxy/user_management_heirarchy.md index 21b0aa63b07..4611f1265dc 100644 --- a/docs/my-website/docs/proxy/user_management_heirarchy.md +++ b/docs/my-website/docs/proxy/user_management_heirarchy.md @@ -12,6 +12,15 @@ LiteLLM supports a hierarchy of users, teams, organizations, and budgets. - Users can have multiple keys, and be on multiple teams. [API Reference](https://litellm-api.up.railway.app/#/budget%20management) - Keys can belong to either a team or a user. [API Reference](https://litellm-api.up.railway.app/#/end-user%20management) +## Entity Overview + +| Entity | Database Table | Description | Key Relationships | +|--------|---------------|-------------|-------------------| +| **Organization** | `LiteLLM_OrganizationTable` | Top-level entity for grouping teams | Contains multiple teams | +| **Team** | `LiteLLM_TeamTable` | Group of users with shared settings and budgets | Belongs to an organization, contains multiple users via team membership | +| **Internal User** | `LiteLLM_UserTable` | Users who can create keys and make LLM API calls | Can own keys, can exist across multiple teams, can belong to multiple organizations | +| **API Key** | `LiteLLM_VerificationTokenTable` | Authentication credentials for API access | Can be owned by either a user or a team (or both) | + :::info