BerriAI/litellm · error · HTTPException

Document blocked by Prompt Security. Violations: {', '.join(

Error message

Document blocked by Prompt Security. Violations: {', '.join(violations)}

What it means

Error "Document blocked by Prompt Security. Violations: {', '.join(violations)}" thrown in BerriAI/litellm.

Source

Thrown at litellm/proxy/guardrails/guardrail_hooks/prompt_security/prompt_security.py:535

                filename = "document.pdf"
            elif "word" in mime_type or "docx" in mime_type:
                filename = "document.docx"
            elif "excel" in mime_type or "xlsx" in mime_type:
                filename = "document.xlsx"
            else:
                extension: Final = mime_type.split("/")[-1]
                filename = f"document.{extension}"

            verbose_proxy_logger.info("Sanitizing document: %s", filename)

            sanitization_result: Final = await self.sanitize_file_content(
                file_data, filename, user_api_key_alias=user_api_key_alias
            )
            action: Final = sanitization_result.get("action")

            if action == "block":
                violations: Final = sanitization_result.get("violations", [])
                raise HTTPException(
                    status_code=400,
                    detail=f"Document blocked by Prompt Security. Violations: {', '.join(violations)}",
                )

            if action == "modify":
                sanitized_content: Final = sanitization_result.get("content", "")
                if sanitized_content:
                    sanitized_encoded: Final = base64.b64encode(
                        sanitized_content if isinstance(sanitized_content, bytes) else sanitized_content.encode()
                    ).decode()

                    if url.startswith("data:") and header:
                        sanitized_url: Final = f"{header},{sanitized_encoded}"
                        if isinstance(doc_data, dict):
                            doc_data["url"] = sanitized_url
                    elif isinstance(doc_data, dict):
                        doc_data["data"] = sanitized_encoded

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Remove the violating content from the document.
2. Review the Prompt Security document policies that produced the violations.

When it happens

Trigger: Thrown at litellm/proxy/guardrails/guardrail_hooks/prompt_security/prompt_security.py:535 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/3f216adcd613808b. Report an issue: GitHub.