From 01063bab2bbaba2d728e276105fc5220ae41777d Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 19 Mar 2026 19:49:30 +0000 Subject: [PATCH] Add entity overview table to user management hierarchy docs Added a summary table describing the user tenant management hierarchy including: - Organization, Team, Internal User, and API Key entities - Database table names for each entity - Brief descriptions and key relationships Co-authored-by: Krish Dholakia --- docs/my-website/docs/proxy/user_management_heirarchy.md | 9 +++++++++ 1 file changed, 9 insertions(+) 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