BerriAI/litellm · error · ValueError

IBM Guardrails: guardrail_name is required

Error message

IBM Guardrails: guardrail_name is required

What it means

Error "IBM Guardrails: guardrail_name is required" thrown in BerriAI/litellm.

Source

Thrown at litellm/proxy/guardrails/guardrail_hooks/ibm_guardrails/__init__.py:24

from .ibm_detector import IBMGuardrailDetector

if TYPE_CHECKING:
    from litellm.types.guardrails import Guardrail, LitellmParams


def initialize_guardrail(litellm_params: "LitellmParams", guardrail: "Guardrail"):
    import litellm

    if not litellm_params.auth_token:
        raise ValueError("IBM Guardrails: auth_token is required")
    if not litellm_params.base_url:
        raise ValueError("IBM Guardrails: base_url is required")
    if not litellm_params.detector_id:
        raise ValueError("IBM Guardrails: detector_id is required")

    guardrail_name: Final = guardrail.get("guardrail_name")
    if not guardrail_name:
        raise ValueError("IBM Guardrails: guardrail_name is required")

    verify_ssl: Final = getattr(litellm_params, "verify_ssl", True)

    # Get optional params
    optional_params: Final = getattr(litellm_params, "optional_params", IBMDetectorOptionalParams())
    detector_params: Final = getattr(optional_params, "detector_params", {})
    extra_headers: Final = getattr(optional_params, "extra_headers", {})
    score_threshold: Final = getattr(optional_params, "score_threshold", None)
    block_on_detection: Final = getattr(optional_params, "block_on_detection", True)

    is_detector_server = litellm_params.is_detector_server
    if is_detector_server is None:
        is_detector_server = True

    ibm_guardrail: Final = IBMGuardrailDetector(
        guardrail_name=guardrail_name,
        auth_token=litellm_params.auth_token,
        base_url=litellm_params.base_url,

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Set guardrail_name in the ibm_guardrails guardrail configuration.
2. Give the guardrail a unique, non-empty name in the config file and restart the proxy.

When it happens

Trigger: Thrown at litellm/proxy/guardrails/guardrail_hooks/ibm_guardrails/__init__.py:24 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/18aa014ab08064a6. Report an issue: GitHub.