Skip to main content
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 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 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 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 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 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 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.
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
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 with the canvas content type and export format you attempted.

​
Quick Reference Table

Error MessageMost Common CauseQuick Fix
Rate limit reachedMonthly premium quota exhaustedUse standard model or upgrade
Daily limit reachedFree plan daily cap hitWait for midnight UTC reset
Model temporarily unavailableProvider outageSwitch models, wait, check status
Upload failed — file too largeFile exceeds 50 MB / 200 MBCompress or split the file
Upload failed — unsupported file typeFormat not supportedConvert to supported format
Upload timed outSlow connection + large fileFaster network or smaller file
Session expiredAuth token expiredClick anywhere to re-login
Connector authorization failedOAuth token expired/revokedSettings → Connectors → Reconnect
Agent action blockedScope or safety checkReview Agent Activity sidebar
Canvas export failedRender timeout or format issueRetry or try different format