Error Messages Reference
Overview
Complete reference for error messages you might encounter in Solatis, with explanations and solutions.
Authentication Errors
AUTH_001: Invalid credentials
Cause: Wrong email or password
Solutions:
- Verify email address spelling
- Check Caps Lock
- Use "Forgot Password" to reset
- Try different account
AUTH_002: Session expired
Cause: JWT token expired (>1 hour old)
Solutions:
- Refresh page to get new token
- Log out and log back in
- Clear browser cache
- Check session timeout settings
AUTH_003: Two-factor authentication required
Cause: 2FA enabled but code not provided
Solutions:
- Enter 6-digit code from authenticator
- Use backup code if no access to authenticator
- Contact support to reset 2FA
AUTH_004: Account locked
Cause: Multiple failed login attempts
Solutions:
- Wait 15 minutes
- Use "Forgot Password" to reset
- Contact support if persistent
Permission Errors
PERM_001: Insufficient permissions
Cause: User lacks required permission for action
Solutions:
- Contact workspace admin
- Request permission upgrade
- Verify correct workspace
- Check if document/project restricted
PERM_002: Workspace access denied
Cause: User not member of workspace
Solutions:
- Request invitation from workspace admin
- Verify workspace ID correct
- Check if workspace deleted
- Try different workspace
PERM_003: Document access denied
Cause: Document not shared with user
Solutions:
- Request sharing from document owner
- Verify document ID correct
- Check if document deleted
- Try searching by name instead
Upload Errors
UPLOAD_001: File too large
Cause: File exceeds size limit
Limits:
- Free: 25MB
- Standard: 75MB
- Pro: 150MB
- Enterprise: 500MB
Solutions:
- Compress file (PDF, images)
- Split into multiple files
- Use cloud storage integration
- Upgrade plan
UPLOAD_002: Unsupported file type
Cause: File format not supported
Supported: PDF, DOCX, TXT, RTF, MP3, M4A, WAV, MP4, MOV, XLSX, PPTX
Solutions:
- Convert to supported format
- Extract text and upload as TXT
- Contact support for format request
UPLOAD_003: Upload failed
Cause: Network issue or server error
Solutions:
- Check internet connection
- Try again
- Try different browser
- Reduce file size
- Try during off-peak hours
UPLOAD_004: Virus detected
Cause: File failed security scan
Solutions:
- Scan file with antivirus locally
- Remove infected content
- Try different file
- Contact support if false positive
Processing Errors
PROC_001: Processing failed
Cause: Error during document processing
Solutions:
- Check file not corrupted
- Try re-uploading
- Verify file format correct
- Contact support with document ID
PROC_002: OCR failed
Cause: Cannot extract text from scanned PDF
Solutions:
- Ensure scan quality (300+ DPI)
- Verify text is machine-printed
- Convert to text-based PDF
- Manually extract text
PROC_003: Transcription failed
Cause: Audio/video transcription error
Solutions:
- Check audio quality
- Verify supported format
- Reduce background noise
- Try shorter segments
- Contact support
PROC_004: Processing timeout
Cause: Processing took too long (>30 min)
Solutions:
- Try smaller file
- Split into segments
- Try during off-peak
- Contact support for large files
Search Errors
SEARCH_001: No results found
Cause: Query didn't match any documents
Solutions:
- Try different keywords
- Check spelling
- Broaden search terms
- Verify documents processed
- Clear filters
SEARCH_002: Search timeout
Cause: Query took too long
Solutions:
- Simplify query
- Add filters (date, type)
- Reduce scope
- Try again later
SEARCH_003: Invalid query
Cause: Malformed search syntax
Solutions:
- Check query syntax
- Remove special characters
- Simplify query
- Use plain text search
Integration Errors
INT_001: Integration not connected
Cause: OAuth connection expired or invalid
Solutions:
- Re-authorize integration
- Check permissions granted
- Verify credentials
- Reconnect integration
INT_002: Sync failed
Cause: Error syncing with external service
Solutions:
- Check integration status
- Re-authorize if needed
- Verify API credentials
- Check rate limits
- Try manual sync
INT_003: API rate limit exceeded
Cause: Too many API calls to external service
Solutions:
- Wait and retry (see Retry-After header)
- Reduce sync frequency
- Batch operations
- Request limit increase
INT_004: Webhook delivery failed
Cause: Cannot deliver webhook to endpoint
Solutions:
- Verify endpoint accessible
- Check firewall rules
- Verify SSL certificate
- Check webhook logs
Agent Errors
AGENT_001: Agent execution failed
Cause: Error running AI agent
Solutions:
- Check agent configuration
- Verify integrations connected
- Review agent logs
- Test agent manually
- Contact support
AGENT_002: Action failed
Cause: Agent action (create task, etc.) failed
Solutions:
- Verify integration permissions
- Check API credentials
- Review error logs
- Test action manually
- Adjust agent config
AGENT_003: Trigger condition not met
Cause: Agent trigger requirements not satisfied
Solutions:
- Review trigger conditions
- Check filter criteria
- Verify event occurred
- Test trigger manually
API Errors
API_001: Invalid API key
Cause: API key invalid or expired
Solutions:
- Verify API key correct
- Generate new key
- Check key scope
- Verify environment (prod vs dev)
API_002: Rate limit exceeded
Cause: Too many API requests
Limits:
- Free: 100/min
- Standard: 500/min
- Pro: 1000/min
- Enterprise: Custom
Solutions:
- Implement rate limiting
- Add retry logic with backoff
- Batch requests
- Upgrade plan
- Request increase
API_003: Invalid request
Cause: Malformed API request
Solutions:
- Check request format (JSON)
- Verify required fields
- Check data types
- Review API documentation
- Use SDK if available
API_004: Resource not found
Cause: Requested resource doesn't exist
Solutions:
- Verify resource ID correct
- Check if resource deleted
- Verify permissions
- Use search to find resource
Billing Errors
BILL_001: Payment failed
Cause: Credit card declined
Solutions:
- Verify card details correct
- Check sufficient funds
- Try different card
- Contact bank
- Update payment method
BILL_002: Subscription expired
Cause: Subscription ended, payment failed
Solutions:
- Update payment method
- Renew subscription
- Contact billing support
- Review invoice
BILL_003: Usage limit exceeded
Cause: Used more than plan allows
Solutions:
- Wait for next billing period
- Upgrade plan
- Purchase additional capacity
- Review usage
System Errors
SYS_001: Internal server error
Cause: Unexpected server error
Solutions:
- Try again in a few minutes
- Check status page
- Contact support with:
- Error ID
- Timestamp
- What you were doing
SYS_002: Service unavailable
Cause: Service temporarily down
Solutions:
- Check status page
- Wait and retry
- Subscribe to status updates
SYS_003: Database connection failed
Cause: Cannot connect to database
Solutions:
- Wait a few minutes
- Try again
- Check status page
- Contact support if persistent
Getting Help
When Reporting Errors:
Include:
- Error code and message
- What you were doing
- Steps to reproduce
- Screenshots
- Browser/device info
- Timestamp
- Account email
Contact Methods:
- Email: support@solatis.team
- In-app chat: Click "?" icon
- Status page: status.solatis.com
- Community: community.solatis.com
Next Steps
- Common Issues - Quick solutions
- FAQ - Frequently asked questions
- Contact Support - Get personalized help
Last Updated: October 11, 2025