BerriAI/litellm · error · HTTPException

Invalid sort column. Must be one of: {', '.join(valid_column

Error message

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

What it means

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

Source

Thrown at litellm/proxy/management_endpoints/key_management_endpoints.py:5788

        )


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 = [
        "spend",
        "max_budget",
        "created_at",
        "updated_at",
        "token",
        "key_alias",
    ]
    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


def _build_expires_where_clause(expires_filter: str, now: datetime) -> dict[str, object]:
    if expires_filter == "expired":

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Use one of the listed valid sort columns in the sort_by parameter.
2. Omit sort_by to use the default ordering.

When it happens

Trigger: Thrown at litellm/proxy/management_endpoints/key_management_endpoints.py:5788 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/16410e376284cf5b. Report an issue: GitHub.