Common Issues

Common issues and solutions for Solo. If you don't find your issue here, check the specific sections or contact support.

Account Issues

Can't Sign In

Symptoms: Unable to sign in to Solo

Solutions:

  • Check email and password are correct
  • Try password reset
  • Verify email is verified
  • Check for account lockout
  • Contact support if issues persist

Email Not Verified

Symptoms: Email verification required

Solutions:

  • Check spam folder for verification email
  • Request new verification email
  • Verify email address is correct
  • Contact support if email not received

Account Locked

Symptoms: Account temporarily locked

Solutions:

  • Wait for lockout period to expire
  • Try password reset
  • Contact support to unlock account
  • Review security settings

Identity Issues

Can't Claim Identity

Symptoms: Unable to claim Solo Identity

Solutions:

  • Check handle is available
  • Try different handle
  • Verify email is verified
  • Check for errors in console
  • Contact support if issues persist

Identity Not Active

Symptoms: Identity shows as inactive

Solutions:

  • Verify identity was created successfully
  • Check identity settings
  • Review activation status
  • Contact support if needed

Wrong Identity Email

Symptoms: Email address doesn't match

Solutions:

  • Verify identity handle is correct
  • Check email format
  • Review identity settings
  • Contact support to update

Email Issues

Emails Not Arriving

Symptoms: Emails not received at Solo Identity

Solutions:

  • Check spam folder
  • Verify email address is correct
  • Check email settings
  • Review agent configuration
  • Contact support if issues persist

Emails Not Sending

Symptoms: Unable to send emails

Solutions:

  • Check internet connection
  • Verify recipient address is valid
  • Check for error messages
  • Review email size (attachments)
  • Contact support if needed

Agent Not Processing Emails

Symptoms: Inbox Manager not handling emails

Solutions:

  • Check Inbox Manager is active
  • Verify agent configuration
  • Check for errors in logs
  • Review agent activity
  • Contact support if needed

Agent Issues

Agent Not Working

Symptoms: Agent not performing actions

Solutions:

  • Check agent is active
  • Verify agent configuration
  • Review agent logs
  • Check for errors
  • Contact support if needed

Agent Not Responding

Symptoms: Agent not responding to requests

Solutions:

  • Check agent status
  • Verify agent is active
  • Review agent configuration
  • Check for rate limits
  • Contact support if needed

Agent Errors

Symptoms: Agent showing errors

Solutions:

  • Review error messages
  • Check agent configuration
  • Verify agent permissions
  • Review agent logs
  • Contact support if needed

Workflow Issues

Workflows Not Running

Symptoms: Workflows not executing

Solutions:

  • Check workflow status
  • Verify workflows are enabled
  • Review workflow configuration
  • Check for errors in logs
  • Contact support if needed

Usage Not Tracking

Symptoms: Token usage or executions not tracked

Solutions:

  • Check you're using default workflows
  • Verify identity is activated
  • Check Settings → Workflow
  • Review API key configuration
  • Contact support if issues persist

Custom Workflow Tool Not Working

Symptoms: Custom workflow tool workflows failing

Solutions:

  • Check webhook URL is correct
  • Verify API key is valid
  • Check your workflow tool instance is running
  • Review your workflow tool's logs
  • Contact support if needed

Performance Issues

Slow Loading

Symptoms: Solo loads slowly

Solutions:

  • Check internet connection
  • Clear browser cache
  • Try different browser
  • Check for browser extensions
  • Contact support if issues persist

Timeouts

Symptoms: Requests timing out

Solutions:

  • Check internet connection
  • Verify service status
  • Try again later
  • Check for rate limits
  • Contact support if needed

General Troubleshooting

Clear Cache

Clear browser cache:

  1. Open browser settings
  2. Clear browsing data
  3. Select cache/cookies
  4. Clear data
  5. Refresh Solo

Check Browser Console

View browser console for errors:

  1. Open browser developer tools (F12)
  2. Go to Console tab
  3. Look for errors
  4. Note error messages
  5. Contact support with details

Check Network

Verify network connection:

  • Test internet connection
  • Check firewall settings
  • Verify DNS settings
  • Test with different network

Getting Help

Documentation

  • Check documentation: Review relevant docs
  • Search docs: Search for your issue
  • Read guides: Follow step-by-step guides

Support

If you can't resolve the issue:

  • Contact support: Reach out to support team
  • Provide details: Include error messages and steps to reproduce
  • Check status: Verify service status
  • Be patient: Support will respond

Next Steps

Version: 1.0
Last Updated: November 2025