Skip to content

docs(model_armor): document skip_unscannable_attachments and max_file_attachments - #589

Merged
yucheng-berri merged 3 commits into
mainfrom
litellm_model_armor_skip_unscannable_docs
Jul 16, 2026
Merged

docs(model_armor): document skip_unscannable_attachments and max_file_attachments#589
yucheng-berri merged 3 commits into
mainfrom
litellm_model_armor_skip_unscannable_docs

Conversation

@devin-ai-integration

@devin-ai-integration devin-ai-integration Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Summary

Companion docs for BerriAI/litellm#33554, which fixes the v1.92.0 Model Armor regression where attachment shapes that worked on v1.91.x started returning HTTP 400.

Updates docs/proxy/guardrails/model_armor.md:

  • Documents skip_unscannable_attachments (default false): lets reference-only attachments (file_id, gs://, http(s)://) and undecodable inline base64 pass through unscanned, while fail_on_error still governs real Model Armor API errors.
  • Documents max_file_attachments (default 10): the per-request attachment cap is now configurable. Over the cap blocks under fail_on_error: true; under fail_on_error: false every attachment is scanned rather than silently dropping the overflow (the old truncate-to-10 behavior).
  • Corrects the "Attachments That Cannot Be Scanned" table row for over-cap requests (was "first 10 scanned, rest pass through unscanned") and clarifies that oversize documents (>4 MB) stay fail-closed by default and are not covered by skip_unscannable_attachments.

Verified with npm run build (no new warnings from this page).

Link to Devin session: https://app.devin.ai/sessions/2a1e5e4797394ff79c4d8d6a9513d2f0
Requested by: @yucheng-berri

@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@vercel

vercel Bot commented Jul 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
litellm Ready Ready Preview, Comment Jul 16, 2026 7:24pm

Request Review

…osed behavior

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration devin-ai-integration Bot changed the title docs(model_armor): document skip_unscannable_attachments option docs(model_armor): document skip_unscannable_attachments and max_file_attachments Jul 16, 2026
…ttachment is scanned

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@yucheng-berri
yucheng-berri merged commit 2ba19dd into main Jul 16, 2026
3 checks passed
@yucheng-berri
yucheng-berri deleted the litellm_model_armor_skip_unscannable_docs branch July 16, 2026 23:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant