Windsurf storage

Signed URLs Expiring Too Fast in Windsurf App

Images, documents, and file download links in your Windsurf-generated app break after a short time. Users see broken images, get access denied errors when clicking download links, or see files that loaded fine moments ago now showing 403 Forbidden errors.

This happens because your app uses signed URLs to serve files from private cloud storage (Supabase Storage, S3, or GCS), and the URLs expire too quickly. Cascade may have set a very short expiration time, or the URLs are being generated once and cached while the expiration passes.

The issue is especially frustrating for users because everything appears to work initially, then breaks silently. Pages that worked fine a few minutes ago suddenly show broken images everywhere.

Error Messages You Might See

403 Forbidden: Request has expired AccessDenied: Request has expired The provided token has expired SignatureDoesNotMatch Error: URL signature expired
403 Forbidden: Request has expiredAccessDenied: Request has expiredThe provided token has expiredSignatureDoesNotMatchError: URL signature expired

Common Causes

  • Default short expiration — Cascade used the default signed URL expiration (often 60 seconds) without increasing it for the use case
  • URLs cached but not refreshed — Signed URLs are generated once at page load and stored in state, but not regenerated when they expire
  • Server-side rendering with stale URLs — URLs generated during SSR are already partially expired by the time the client receives them
  • Email or notification links — Signed URLs sent in emails expire before the recipient opens the message
  • CDN caching conflicts — A CDN caches the page with signed URLs, but the URLs expire before the CDN cache does

How to Fix It

  1. Increase signed URL expiration — Set expiration to match your use case: 1 hour for page views, 24 hours for download links, 7 days for email links
  2. Implement URL refresh logic — Create a client-side mechanism that regenerates signed URLs before they expire, or on 403 errors
  3. Use public buckets for non-sensitive files — If the files aren't private (like product images), make the bucket public and skip signed URLs entirely
  4. Add a redirect endpoint — For email links, create a permanent URL (/files/:id/download) that generates a fresh signed URL and redirects
  5. Set CDN cache to match URL expiration — Ensure CDN cache-control headers expire before the signed URLs they contain

Real developers can help you.

legrab legrab I'll fill this later Sage Fulcher Sage Fulcher Hey I'm Sage! Im a Boston area software engineer who grew up in South Florida. Ive worked at a ton of cool places like a telehealth kidney care startup that took part in a billion dollar merger (Cricket health/Interwell health), a boutique design agency where I got to work on a ton of exciting startups including a photography education app, a collegiate Esports league and more (Philosophie), a data analytics as a service startup in Cambridge (MA) as well as at Phillips and MIT Lincoln Lab where I designed and developed novel network security visualizations and analytics. I've been writing code and furiously devoted to using computers to make people’s lives easier for about 17 years. My degree is in making computers make pretty lights and sounds. Outside of work I love hip hop, the Celtics, professional wrestling, magic the gathering, photography, drumming, and guitars (both making and playing them) Matthew Butler Matthew Butler Systems Development Engineer @ Amazon Web Services prajwalfullstack prajwalfullstack Hi Im a full stack developer, a vibe coded MVP to Market ready product, I'm here to help MFox MFox Full-stack professional senior engineer (15+years). Extensive experience in software development, qa, and IP networking. Jaime Orts-Caroff Jaime Orts-Caroff I'm a Senior Android developer, open to work in various fields Prakash Prajapati Prakash Prajapati I’m a Senior Python Developer specializing in building secure, scalable, and highly available systems. I work primarily with Python, Django, FastAPI, Docker, PostgreSQL, and modern AI tooling such as PydanticAI, focusing on clean architecture, strong design principles, and reliable DevOps practices. I enjoy solving complex engineering problems and designing systems that are maintainable, resilient, and built to scale. Yovel Cohen Yovel Cohen I got a lot of experience in building Long-horizon AI Agents in production, Backend apps that scale to millions of users and frontend knowledge as well. Luca Liberati Luca Liberati I work on monoliths and microservices, backends and frontends, manage K8s clusters and love to design apps architecture Meïr Ankri Meïr Ankri Full-stack developer specializing in React / Next.js / Node.js with 6+ years of experience. I've worked across various sectors including automotive (Reezocar/Société Générale), healthcare (Medical Link SaaS), and e-commerce (Glasman). I build web apps end-to-end, from architecture to production, with a focus on scalability, performance, and code quality. I also mentor junior developers and contribute to technical decisions and code reviews.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help

Frequently Asked Questions

How long should I set signed URL expiration?

It depends on the use case. For images displayed on pages: 1-4 hours. For download links: 24 hours. For links in emails: 7 days. For public content that doesn't need access control, skip signed URLs and use public buckets.

Can signed URLs be extended after they are created?

No. Once a signed URL is generated, its expiration is fixed. You must generate a new signed URL. Design your app to either refresh URLs before expiry or use a redirect endpoint that generates fresh URLs on demand.

Related Windsurf Issues

Can't fix it yourself?
Real developers can help.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help