Troubleshooting

Running into a problem? Below are solutions to the most common issues. If you do not see your issue listed here, check the FAQ or contact our support team.

---

My Flow is not responding or returns an error

If your Flow fails to produce a result or shows an error message, try these steps:

1. Check your API key. Go to Settings > Integrations and make sure the API key for your chosen provider (OpenAI, Anthropic, etc.) is entered correctly and still active.
2. Verify the model. Make sure the model you selected in the Agent node is available under your API plan. Some models require a paid tier or specific access.
3. Review the execution logs. Open History and find the run in question. The logs will show exactly where the workflow failed and what error was returned.

---

I cannot see my Flow in the Suite

If a Flow is missing from your Suite, check two things:

1. Publish a live version. Open the Flow, click Publish, and make sure the "Make this version live" option is checked. Only live versions appear in Suites.
2. Check the Suite status. Go to Suites, open the Suite, and confirm its status is set to Active. Flows inside inactive Suites will not be visible to end users.

---

Web search or scraping is not working

If your Flow is supposed to search the web or scrape a page but nothing happens:

1. Toggle the feature on. Open your workflow, select the Agent node, and make sure web search or web scraping is enabled in the node settings.
2. Check the required API keys. Some search and scraping features require additional API keys. Verify they are configured in Settings > Integrations.

---

My share link does not work

If someone clicks your share link and sees an error or a blank page:

1. Set the Suite to Active. Go to Suites, open the Suite, and make sure its status is Active.
2. Publish at least one Flow. The Suite needs at least one Flow with a live published version before the share link will work.

---

Knowledge sources stuck on "Processing"

If a file you uploaded to Notebooks stays in the "Processing" state for a long time:

1. Give it a moment. Large files can take several minutes to process, depending on size and format.
2. Re-upload the file. If it has been stuck for an extended period, try deleting the source and uploading it again.
3. Check the file format. Make sure you are using a supported format (PDF, DOCX, TXT, CSV, and similar document types).

---

A team member cannot access certain features

If someone on your team is locked out of a feature:

1. Check their role. Go to Settings > Members and review the role assigned to that person.
2. Understand role permissions.
   • Viewers have read-only access - they can see Flows and settings but cannot make changes.
   • Members can create and edit Flows and Suites but cannot manage organization-level settings or integrations.
   • Admins and Owners have broader access, including settings and member management.

If they need more access, an Owner or Admin can update their role from the Members page.

---

Embed is not displaying correctly

If your embedded Flow does not load or looks broken on your website:

1. Check the authorized domains. Open the Suite's settings and make sure your website's domain is listed in the authorized URLs. Embeds will not load on domains that are not authorized.
2. Verify embedding is enabled. In the Suite settings, confirm that embedding is turned on.
3. Inspect the iframe code. Make sure the embed snippet was pasted correctly into your page's HTML without any extra characters or missing quotes.