# Common Issues

## Introduction

This page covers frequently encountered issues and their solutions. Use this as a first reference when troubleshooting problems with assignments.

***

## Connection Issues

### "Connection Not Connected"

**Symptoms:**

* Assignment fails when trying to use a connection
* Error message about missing or invalid connection

**Solutions:**

1. Go to Resources → Connections
2. Find the affected connection
3. Check if it shows as connected
4. If disconnected, click to reconnect and re-authorize
5. Return to the assignment and try again

### "Authentication Failed"

**Symptoms:**

* Connection was working but stopped
* Errors about invalid tokens or logins

**Solutions:**

1. Tokens may have expired—reconnect the connection
2. Check if password was changed on the external service
3. Verify the external service account is still active
4. Re-authorize the connection

### "Permission Denied"

**Symptoms:**

* Connection works but specific actions fail
* Errors about insufficient permissions

**Solutions:**

1. Check what permissions were granted during connection
2. The external service may have changed permission requirements
3. Reconnect with appropriate permissions
4. Verify the account has access to the specific resources needed

***

## Assignment Execution Issues

### Assignment Runs But Does Nothing

**Symptoms:**

* Job completes successfully
* But no visible actions were taken

**Possible Causes:**

* SOP doesn't match current data conditions
* Assignment is waiting for something that isn't present
* Logic depends on conditions that aren't met

**Solutions:**

1. Review the job logs to see what the assignment did
2. Check if expected data/emails/files were present
3. Verify trigger conditions are being met
4. Test with known data to confirm assignment works

### Assignment Takes Too Long

**Symptoms:**

* Jobs time out before completing
* Very long execution times

**Possible Causes:**

* Processing too much data at once
* Slow responses from external services
* Inefficient instructions

**Solutions:**

1. Break large tasks into smaller chunks
2. Process data in batches
3. Check if external services are responsive
4. Simplify instructions where possible

### Assignment Stops Mid-Execution

**Symptoms:**

* Job starts but doesn't complete
* No error message, just stops

**Possible Causes:**

* Unexpected data format
* Edge case not handled in SOP
* Connection rate limiting

**Solutions:**

1. Check job logs for where it stopped
2. Review what data was being processed at that point
3. Update SOP to handle the situation
4. Check connection status and quotas

***

## Human-in-the-Loop Issues

### Requests Not Appearing

**Symptoms:**

* Assignment should pause for approval
* No request shows in Activity Inbox

**Solutions:**

1. Verify the assignment is configured for human-in-the-loop
2. Check that the job actually reached that point
3. Look in both Pending and Answered tabs
4. Verify you're viewing the correct team's inbox

### Can't Respond to Requests

**Symptoms:**

* Request visible but response doesn't work
* Error when trying to approve/respond

**Solutions:**

1. Check that the job is still active (not timed out)
2. Verify you have permission to respond
3. Refresh the page and try again
4. Check if another user already responded

***

## Scheduling Issues

### Scheduled Jobs Not Starting

**Symptoms:**

* Assignment should run on schedule
* But jobs don't appear at expected times

**Solutions:**

1. Verify the schedule is enabled
2. Check the timezone setting
3. Confirm the schedule frequency and time
4. Look for any errors in recent job attempts

### Jobs at Wrong Times

**Symptoms:**

* Assignment runs but not when expected
* Timing seems off

**Solutions:**

1. Check timezone configuration
2. Verify the schedule settings
3. Account for daylight saving time changes
4. Confirm the frequency setting (daily, weekly, etc.)

***

## Login Issues

### Stored Logins Not Working

**Symptoms:**

* Browser-based assignment can't log in
* Saved logins rejected

**Solutions:**

1. Verify the logins are current
2. Check if the website changed its login process
3. Update stored logins if password changed
4. Verify 2FA settings if applicable

### 2FA Problems

**Symptoms:**

* Login fails at 2FA step
* TOTP codes not accepted

**Solutions:**

1. Verify TOTP is configured correctly in Duvo
2. Check time synchronization (TOTP is time-sensitive)
3. Re-sync the authenticator if needed
4. Verify the correct account is linked

***

## General Troubleshooting Steps

### When Something Stops Working

1. **Check recent changes** - Did anything change recently?
2. **Verify connections** - Are all connections active?
3. **Review job logs** - What does the debug information show?
4. **Test manually** - Can you do the task manually?
5. **Isolate the issue** - Which specific part is failing?

### When Starting Fresh

1. Test each connection individually
2. Start with simple instructions
3. Add complexity gradually
4. Test after each change
5. Document what works

***

## Getting Help

If you can't resolve an issue:

1. Document what you've tried
2. Gather relevant job IDs and error messages
3. Note when the issue started
4. Contact support with this information