Workflow Is Stuck or Not Completing

Symptom

Your workflow has been in Running status for more than 15 minutes, or it completed with a status of Failed with no clear error message.

---

Common Causes & Fixes

1. Integration Credentials Expired

The most common cause. Cloud provider keys and OAuth tokens expire.

Fix:

1. Go to Settings → Integrations
2. Look for any integration showing a red ⚠️ badge
3. Click Re-authenticate and follow the prompts
4. Once credentials are refreshed, go back to the workflow and click Retry

---

2. Rate Limit Hit

Some integrations (e.g., GitHub API, cloud provider APIs) have rate limits. Nexxis automatically retries, but very large projects may take longer.

Fix:

• Wait 10 minutes and check if the workflow auto-resumed
• If not, click Retry manually
• For persistent issues, contact support — we can increase your integration polling interval

---

3. Insufficient Permissions

Your cloud provider integration may not have permission to read specific services.

Fix:

1. Go to Settings → Integrations → [Your Provider] → Test Connection
2. The test will show which permissions are missing
3. Update your IAM Role / Service Account with the required permissions
4. Retry the workflow

---

4. Very Large Project

Projects with 500+ controls or 10+ integrations can take 20–30 minutes for a full scan.

Fix:

• Check the Activity Log for progress updates (the workflow is probably still running)
• If it's been over 45 minutes, click Cancel and Retry

---

5. Temporary Service Disruption

Rarely, an underlying cloud provider API is experiencing issues.

Fix:

1. Check the Nexxis Status Page for any active incidents
2. If your cloud provider has a reported outage, wait for it to resolve and retry

---

Still Stuck?

Click the ? button in the workflow detail view to create a support ticket. We automatically attach workflow logs to make diagnosis faster.