BerriAI/litellm · error · HTTPException

Maximum {MAX_BATCH_SIZE} members can be added at once

Error message

Maximum {MAX_BATCH_SIZE} members can be added at once

What it means

Error "Maximum {MAX_BATCH_SIZE} members can be added at once" thrown in BerriAI/litellm.

Source

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

        data.members = [
            Member(
                user_id=user.user_id,
                user_email=user.user_email,
                role="user",
            )
            for user in all_users_in_db
        ]

    if not data.members:
        raise HTTPException(
            status_code=400,
            detail={"error": "At least one member is required"},
        )

    # Limit batch size to prevent overwhelming the system
    MAX_BATCH_SIZE: Final = 500
    if len(data.members) > MAX_BATCH_SIZE:
        raise HTTPException(
            status_code=400,
            detail={"error": f"Maximum {MAX_BATCH_SIZE} members can be added at once"},
        )

    try:
        # Reuse the existing team_member_add logic directly
        response: Final = await team_member_add(
            data=TeamMemberAddRequest(
                team_id=data.team_id,
                member=data.members,  # Pass the entire list
                max_budget_in_team=data.max_budget_in_team,
            ),
            user_api_key_dict=user_api_key_dict,
        )

        # Convert to bulk response format
        results = _create_results_from_response(data.members, response)

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Split the request into batches of at most MAX_BATCH_SIZE members each.

When it happens

Trigger: Thrown at litellm/proxy/management_endpoints/team_endpoints.py:3632 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/a3e0ef271e5c6945. Report an issue: GitHub.