BerriAI/litellm · error · HTTPException

Vantage settings not found. Please initialize settings first

Error message

Vantage settings not found. Please initialize settings first using /vantage/init

What it means

The update endpoint found no VANTAGE_SETTINGS_PARAM_NAME row in LiteLLM_Config, meaning /vantage/init was never run (or settings were deleted). Updates are patch-only by design, so the operator must initialize settings before editing them.

Source

Thrown at litellm/proxy/spend_tracking/vantage_endpoints.py:209

    Only admin users can update Vantage settings.
    """
    if user_api_key_dict.user_role != LitellmUserRoles.PROXY_ADMIN:
        raise HTTPException(
            status_code=403,
            detail={"error": CommonProxyErrors.not_allowed_access.value},
        )

    if not any([request.api_key, request.integration_token, request.base_url]):
        raise HTTPException(
            status_code=400,
            detail={"error": "At least one field must be provided for update"},
        )

    try:
        current_settings: Final = await _get_vantage_settings()

        if not current_settings:
            raise HTTPException(
                status_code=404,
                detail={"error": "Vantage settings not found. Please initialize settings first using /vantage/init"},
            )

        updated_api_key: Final = request.api_key if request.api_key is not None else current_settings.get("api_key", "")
        updated_token: Final = (
            request.integration_token
            if request.integration_token is not None
            else current_settings.get("integration_token", "")
        )
        updated_base_url: Final = (
            request.base_url
            if request.base_url is not None
            else current_settings.get("base_url", "https://api.vantage.sh")
        )

        await _set_vantage_settings(
            api_key=updated_api_key,

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Initialize Vantage settings first via the /vantage/init endpoint before updating.

When it happens

Trigger: Thrown at litellm/proxy/spend_tracking/vantage_endpoints.py:209 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/db4bf300acb89393. Report an issue: GitHub.