> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerotwo.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Common Error Messages
> Explanations and fixes for every error message you may encounter in ZeroTwo.
This page covers every common error message in ZeroTwo, what it means, and how to resolve it.
If you see an error not listed here, email [reed@zerotwo.ai](mailto:reed@zerotwo.ai) with the full error text and steps to reproduce.
***
## Error Reference
**What it means:** You have exhausted your monthly premium message quota for your current plan (Pro or Pro 2x). Premium models — Claude Sonnet/Opus, GPT-5, GPT-4o, Gemini 2.5 Pro, Grok-4, and others — count against this monthly cap.
**What ZeroTwo does:** ZeroTwo automatically falls back to a standard model (such as GPT-5-mini, Gemini Flash Lite, or Mistral Small) for that message. Standard models are still high-quality and suitable for most tasks.
**Your options:**
* Continue using the standard fallback model for the rest of the month
* Wait until your billing cycle resets (quota resets at the start of each billing period)
* Upgrade to a higher plan — Pro 2x doubles the monthly quota, Plus Ultra offers unlimited premium messages
See [Plans & Pricing](/overview/plans-and-pricing) for details.
**What it means:** You have hit one of the Free plan's daily limits. Free plan limits include:
* 20 messages/day
* 1 web search/day
* 1 image generation/day
* 1 deep research/day
**What happens:** The specific tool or chat that hit the limit is disabled until the reset.
**Reset time:** All daily limits reset at **midnight UTC** every day.
**Your options:**
* Wait for the midnight UTC reset
* Upgrade to a paid plan (Pro and above have much higher or unlimited limits)
See [Free Plan FAQ](/faq/free-tier-faq) for a full breakdown.
**What it means:** The AI provider hosting this model is experiencing an outage or overload. This is a provider-side issue, not a ZeroTwo account issue.
**How to resolve:**
1. Switch to a different model using the Model Picker in the chat prompt bar
2. Wait a few minutes and try again — provider outages are usually short-lived
3. Check [status.zerotwo.ai](https://status.zerotwo.ai) for any active incident reports
**Common triggers:** High global demand (especially for flagship models), scheduled maintenance windows, or upstream provider incidents.
**What it means:** The file you tried to upload exceeds ZeroTwo's size limits:
* General files (documents, images, audio, code): **50 MB max**
* Video files: **200 MB max**
**How to resolve:**
* Compress the file before uploading (PDF compressors, image resizers, video trimmers)
* Split large documents into smaller parts
* For large videos, extract only the relevant clip
* For images used in vision tasks, a lower resolution version works just as well
See [File Limits Reference](/reference/file-limits-reference) for full details.
**What it means:** The file extension or MIME type is not on ZeroTwo's supported list. ZeroTwo cannot process this file format.
**How to resolve:**
* Convert the file to a supported format before uploading (e.g., export a `.pages` file as `.docx`, or a `.heic` image as `.jpg`)
* See [Supported File Types](/tools/files/supported-file-types) for the full list of accepted formats
**Common unsupported formats:** proprietary formats like `.pages`, `.numbers`, `.keynote`, rare archive types, and some legacy document formats.
**What it means:** Your file upload took longer than **60 seconds** and was terminated. This typically happens with large files on slow connections.
**How to resolve:**
1. Check your internet connection speed — a minimum of \~5 Mbps upload is recommended for larger files
2. Try uploading on a faster network (switch from WiFi to ethernet, or move closer to your router)
3. Try a smaller or more compressed version of the file
4. Retry the upload — transient network issues sometimes clear on their own
If uploads consistently time out, contact [reed@zerotwo.ai](mailto:reed@zerotwo.ai).
**What it means:** Your authentication session has expired. ZeroTwo uses time-limited session tokens for security. This is normal behavior after extended periods of inactivity.
**How to resolve:**
* Click anywhere on the ZeroTwo interface — you'll be automatically prompted to log in again
* Your previous chats and data are safe; only your current session token expired
* If this happens frequently (multiple times per day), try clearing browser cookies for zerotwo.ai and logging in fresh
**Note:** If you're using ZeroTwo in a browser that aggressively clears cookies or storage (some privacy-focused browsers), sessions may expire more quickly.
**What it means:** The OAuth access token for one of your connected apps (Google Drive, Gmail, Notion, GitHub, etc.) has expired or been revoked. This can happen if:
* The app's access was revoked from the third-party side
* The OAuth token naturally expired
* You changed your password on the connected account
**How to resolve:**
1. Go to **Settings → Connectors**
2. Find the affected connector (it will show a warning or disconnected state)
3. Click **Reconnect** and complete the OAuth flow again
4. Re-authorize any scopes ZeroTwo requests
**Prevention:** Avoid revoking ZeroTwo's access in your connected app's security settings unless you intend to disconnect the integration.
**What it means:** Agent Mode attempted to perform an action — such as sending a message, creating a file, or calling an API — that was blocked. This can happen because:
* The action is outside the permission scopes you granted when connecting the app
* A safety check flagged the action as potentially harmful or outside your instructions
* The connected app rejected the API call
**How to resolve:**
1. Open the **Agent Activity sidebar** (visible in Agent Mode) to see a detailed log of what was attempted and why it was blocked
2. If the block was a scope issue, go to **Settings → Connectors**, reconnect the affected app, and grant the required permissions
3. If the block was a safety check, rephrase your request with more specific instructions to clarify the intended action
4. If you believe the block was incorrect, contact [reed@zerotwo.ai](mailto:reed@zerotwo.ai)
**What it means:** ZeroTwo was unable to export your canvas document to the requested format (PDF, DOCX, etc.). This can occur due to:
* A timeout during PDF rendering for very large documents
* A transient server issue during export
* Complex formatting that doesn't convert cleanly to the target format
**How to resolve:**
1. **Wait and retry** — for large documents, PDF generation may take several seconds. Wait 10–15 seconds, then try exporting again.
2. **Try a different format** — if PDF fails, try DOCX. If DOCX fails, try plain text or Markdown.
3. **Refresh the page** and reopen the chat, then try exporting again
4. For very large canvases, consider breaking the document into sections
If export continues to fail, contact [reed@zerotwo.ai](mailto:reed@zerotwo.ai) with the canvas content type and export format you attempted.
***
## Quick Reference Table
| Error Message | Most Common Cause | Quick Fix |
| ------------------------------------- | ------------------------------- | --------------------------------- |
| Rate limit reached | Monthly premium quota exhausted | Use standard model or upgrade |
| Daily limit reached | Free plan daily cap hit | Wait for midnight UTC reset |
| Model temporarily unavailable | Provider outage | Switch models, wait, check status |
| Upload failed — file too large | File exceeds 50 MB / 200 MB | Compress or split the file |
| Upload failed — unsupported file type | Format not supported | Convert to supported format |
| Upload timed out | Slow connection + large file | Faster network or smaller file |
| Session expired | Auth token expired | Click anywhere to re-login |
| Connector authorization failed | OAuth token expired/revoked | Settings → Connectors → Reconnect |
| Agent action blocked | Scope or safety check | Review Agent Activity sidebar |
| Canvas export failed | Render timeout or format issue | Retry or try different format |