# Vercel Blob solution docs

- [Vercel Blob addRandomSuffix, allowOverwrite, and stale files in the cache](https://agenticboilerplate.com/cookbook/vercel-blob/addrandomsuffix-allowoverwrite-and-the-cache): Blob refuses to overwrite by default, and an overwrite can take 60 seconds to show plus whatever the browser cached. Treat blobs as immutable; use new pathnames, not overwrites.
- [Vercel Blob: client uploads vs server uploads and the 4.5 MB limit](https://agenticboilerplate.com/cookbook/vercel-blob/client-uploads-and-the-4-5-mb-body-limit): A Vercel Function accepts at most 4.5 MB of request body. Server uploads hit it; client uploads skip it. How client uploads work, and when a server upload is still right.
- [Deleting orphaned blobs in Vercel Blob](https://agenticboilerplate.com/cookbook/vercel-blob/deleting-orphaned-blobs): Blobs nobody references still bill every month. Where orphans come from, how to delete them in the same code path as the row, and a safe sweep with list() and del() for the rest.
- [Vercel Blob handleUpload: never trust the pathname from the client](https://agenticboilerplate.com/cookbook/vercel-blob/never-trust-the-client-pathname): With client uploads the browser names the pathname and the token is bound to it. Check it in onBeforeGenerateToken, or any signed-in user can write anywhere in your store.
- [Why Vercel Blob onUploadCompleted never fires on localhost](https://agenticboilerplate.com/cookbook/vercel-blob/onuploadcompleted-never-fires-on-localhost): onUploadCompleted is a webhook from Vercel to your app. It cannot reach localhost, so the SDK skips it. Use a tunnel and VERCEL_BLOB_CALLBACK_URL, and never make the upload depend on it.
- [Private vs public Vercel Blob stores: picking one you cannot change](https://agenticboilerplate.com/cookbook/vercel-blob/private-vs-public-blob-stores): A Blob store's access mode is fixed at creation. Private needs a credential for every read; public is readable by anyone with the URL. How to serve each, and why user files belong in private.
- [What Vercel Blob actually costs, and where egress hides](https://agenticboilerplate.com/cookbook/vercel-blob/vercel-blob-costs-and-egress): Storage is cheap. Advanced operations and data transfer are the lines that grow. How each is counted, why private delivery can cost more, and the habits that keep the bill flat.

---

Agentic Boilerplate: A Next.js repo your agent already knows. Free during launch, then $99 once.

- Site map for agents: https://agenticboilerplate.com/llms.txt
- Public API: https://agenticboilerplate.com/openapi.json
- Contact: agenticstudio@gmail.com