Skip to content

docs(files): explain ownership and require_managed_files migration - #3201

Draft
shrey-berri wants to merge 2 commits into
mainfrom
litellm_require_managed_files_access_docs
Draft

shrey-berri wants to merge 2 commits into
mainfrom
litellm_require_managed_files_access_docs

Conversation

@shrey-berri

Copy link
Copy Markdown
Contributor

what to review

Explain who can access uploaded files and how to migrate existing files before enforcing managed IDs

summary

decisions

  • Explain the legacy-file limitation alongside the strict-mode migration

Summary

require_managed_files: false records ownership for new plain-provider and model-routed uploads while preserving their IDs. Non-admin lists show files owned by the caller's user or team, but known untracked raw IDs still pass through

require_managed_files: true requires target_model_names and rejects raw provider IDs for admins and non-admins. The migration example re-uploads the source file and uses the returned unified ID. The config reference links to the updated section

Validated with npm run build and python3 scripts/check-docs.py (1,046 Markdown files, no structural problems). The final prose and anchor edits passed the structural check again

Details

Link to Devin session: https://app.devin.ai/sessions/a4a39d1173934993a004a733af3ca06c
Open in Devin Desktop: https://app.devin.ai/desktop/session/a4a39d1173934993a004a733af3ca06c?variant=devin
Requested by: @shrey-berri

@devin-ai-integration

Copy link
Copy Markdown
Contributor

I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".

  • Disable automatic comment, CI, and merge conflict monitoring

@vercel

vercel Bot commented Nov 20, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
litellm Ready Ready Preview Nov 20, 2026 10:22pm UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview — 2e671916 Deployed Nov 20, 2026 by vercel[bot]
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