Skip to help content
Troubleshooting and status

Upload fails or stalls

Resolve authorization, quota, network, storage, or resumable-upload errors.

Try the safe checks first

  1. Keep the upload page open and check the task's exact message.
  2. Confirm the file still exists and your network is stable.
  3. Resume or retry the existing task rather than starting duplicates.
  4. Check Astral Status for a storage or authentication incident.

Common responses

  • 403: authentication, App Check, reservation, or immutable storage rules rejected the request.
  • 429: a user, plan, network, file-count, pending, or hourly limit was reached; honor Retry-After.
  • Storage temporarily unavailable: retry the same resumable task after checking Status.

Report safely

Note: Include time, route, status code, and the displayed request identifier. Never include access tokens, API keys, PINs, or private download URLs.

Related guides