{"record":{"id":"fcf9c70372f81772","repo":"BerriAI/litellm","slug":"team-id-ui-team-id-is-reserved-for-litellm-ui","errorCode":null,"errorMessage":"team_id '{UI_TEAM_ID}' is reserved for LiteLLM UI dashboard sessions and cannot be used for a real team. Please use a different team id.","messagePattern":"team_id '(.+?)' is reserved for LiteLLM UI dashboard sessions and cannot be used for a real team\\. Please use a different team id\\.","errorType":"http","errorClass":"HTTPException","httpStatus":400,"severity":"error","filePath":"litellm/proxy/management_endpoints/team_endpoints.py","lineNumber":1316,"sourceCode":"            data=data,\n            existing_metadata=None,\n            user_api_key_dict=user_api_key_dict,\n            entity=\"team\",\n        )\n\n        # Check if license is over limit\n        total_teams: Final = await _team_db(prisma_client).count()\n        if total_teams and _license_check.is_team_count_over_limit(team_count=total_teams):\n            raise HTTPException(\n                status_code=403,\n                detail=\"License is over limit. Please contact support@berri.ai to upgrade your license.\",\n            )\n\n        if data.team_id is None:\n            data.team_id = str(uuid.uuid4())\n        else:\n            if data.team_id == UI_TEAM_ID:\n                raise HTTPException(\n                    status_code=400,\n                    detail={\n                        \"error\": f\"team_id '{UI_TEAM_ID}' is reserved for LiteLLM UI dashboard sessions and cannot be used for a real team. Please use a different team id.\"\n                    },\n                )\n            # Check if team_id exists already\n            _existing_team_id: Final = await prisma_client.get_data(\n                team_id=data.team_id, table_name=\"team\", query_type=\"find_unique\"\n            )\n            if _existing_team_id is not None:\n                raise HTTPException(\n                    status_code=400,\n                    detail={\"error\": f\"Team id = {data.team_id} already exists. Please use a different team id.\"},\n                )\n\n        if data.organization_id is None:\n            default_organization_id: Final = _get_default_team_param(\"organization_id\")\n            if isinstance(default_organization_id, str):","sourceCodeStart":1298,"sourceCodeEnd":1334,"githubUrl":"https://github.com/BerriAI/litellm/blob/77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8/litellm/proxy/management_endpoints/team_endpoints.py#L1298-L1334","documentation":"Reserved-id guard: team_id UI_TEAM_ID is used internally for LiteLLM UI dashboard sessions; creating a real team with that id would collide with UI session machinery, so a 400 with guidance to pick another id is raised.","triggerScenarios":"Thrown at litellm/proxy/management_endpoints/team_endpoints.py:1316 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use a different team id; the UI-reserved id cannot be used for real teams."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8","analyzedAt":"2026-08-18T11:44:31.656Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}