BerriAI/litellm · error · HTTPException

f"Invalid sort column. Must be one of: {', '.join(valid_colu

Error message

f"Invalid sort column. Must be one of: {', '.join(valid_columns)}"

What it means

Error "f"Invalid sort column. Must be one of: {', '.join(valid_columns)}"" thrown in BerriAI/litellm.

Source

Thrown at litellm/proxy/management_endpoints/internal_user_endpoints.py:1927

    return result


def _validate_sort_params(sort_by: str | None, sort_order: str) -> dict[str, str] | None:
    order_by: Final[dict[str, str]] = {}

    if sort_by is None:
        return None
    # Validate sort_by is a valid column
    valid_columns: Final = [
        "user_id",
        "user_email",
        "created_at",
        "spend",
        "user_alias",
        "user_role",
    ]
    if sort_by not in valid_columns:
        raise HTTPException(
            status_code=400,
            detail={"error": f"Invalid sort column. Must be one of: {', '.join(valid_columns)}"},
        )

    # Validate sort_order
    if sort_order.lower() not in ["asc", "desc"]:
        raise HTTPException(
            status_code=400,
            detail={"error": "Invalid sort order. Must be 'asc' or 'desc'"},
        )

    order_by[sort_by] = sort_order.lower()

    return order_by


async def _authorize_user_list_request(
    user_api_key_dict: UserAPIKeyAuth,

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Use one of the listed valid sort columns in the sort_by parameter.
2. Check the endpoint documentation for the exact set of sortable columns.

When it happens

Trigger: Thrown at litellm/proxy/management_endpoints/internal_user_endpoints.py:1927 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/821cf61126b9adca. Report an issue: GitHub.