BerriAI/litellm · error · HTTPException

Team max_budget ({data.max_budget}) exceeds organization's m

Error message

Team max_budget ({data.max_budget}) exceeds organization's max_budget ({org_table.litellm_budget_table.max_budget}). Organization: {org_table.organization_id}

What it means

Org-scoped team budget guard: the team's requested max_budget is greater than the organization's own max_budget, so the child would outspend its parent; refused with 400 naming both budgets and the organization id.

Source

Thrown at litellm/proxy/management_endpoints/team_endpoints.py:944

    org_table: LiteLLM_OrganizationTable,
    data: NewTeamRequest | UpdateTeamRequest,
    prisma_client: PrismaClient,
) -> None:
    """
    Check organization team limits including:
    - Team budget vs organization's max_budget
    - Team models vs organization's allowed models
    - Guaranteed throughput limits (tpm/rpm) if applicable
    """

    # Validate team budget against organization's max_budget
    if (
        data.max_budget is not None
        and org_table.litellm_budget_table is not None
        and org_table.litellm_budget_table.max_budget is not None
        and data.max_budget > org_table.litellm_budget_table.max_budget
    ):
        raise HTTPException(
            status_code=400,
            detail={
                "error": f"Team max_budget ({data.max_budget}) exceeds organization's max_budget ({org_table.litellm_budget_table.max_budget}). Organization: {org_table.organization_id}"
            },
        )

    # Validate team models against organization's allowed models
    if data.models is not None and len(org_table.models) > 0:
        # If organization has 'all-proxy-models', skip validation as it allows all models
        if SpecialModelNames.all_proxy_models.value in org_table.models:
            pass
        else:
            for m in data.models:
                if m not in org_table.models:
                    raise HTTPException(
                        status_code=400,
                        detail={
                            "error": f"Model '{m}' not in organization's allowed models. Organization allowed models={org_table.models}. Organization: {org_table.organization_id}"

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Set the team max_budget at or below the organization's max_budget, or raise the org budget first.

When it happens

Trigger: Thrown at litellm/proxy/management_endpoints/team_endpoints.py:944 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@77b7c6c40c (2026-08-18). Data as JSON: /api/errors/6f4920060a50eb05. Report an issue: GitHub.