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:

Check your credits. Runs use the credits included in your plan. Open Settings > Billing and make sure your workspace has credits left for this period.
Check your own API key, if you use one. If you added your own provider key under Settings > Integrations, make sure it is entered correctly, still active, and has access to the model you selected in the Agent node.
Review the execution logs. Open History (called Activity in some workspaces) 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:

Publish a live version. Open the Flow, go to the Publish & Share tab, click Publish Flow, and make sure the "Make this version live" option is checked. Only live versions appear in Suites.
Check the Suite's contents. Go to Assets > Suites, open the Suite, and confirm the Flow has been added to it.

Web search or scraping is not working

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

Toggle the feature on. Open your workflow, select the Agent node, and make sure Web Search or Web Scrape is switched on under AI Capabilities.
Check your credits. Web Search and Web Scrape are built in and need no extra API keys, but each use costs credits. Make sure your workspace has credits left under Settings > Billing.

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

Publish at least one Flow. The Suite needs at least one Flow with a live published version before the share link will work.
Check the domain restriction. If Only allow access on authorized URLs is switched on in the Suite's Settings tab, opening the link directly returns a 404. The Suite only loads when embedded on one of its authorized URLs.

Knowledge sources stuck on "Processing"

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

Give it a moment. Large files can take several minutes to process, depending on size and format.
Re-upload the file. If it has been stuck for an extended period, try deleting the source and uploading it again.
Check the file format. Make sure you are using a supported format: PDF, CSV, TXT, Markdown, or an image. Word files are not supported for upload, so save them as PDF first.

A team member cannot access certain features

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

Check their role. Go to Settings > Members and review the role assigned to that person.
Understand role permissions.
- Viewers can open and run Flows, Agents, and Suites but cannot change anything.
- Members can create and edit Flows, Agents, Suites, and Knowledgebases, but cannot delete items, connect integrations or store API keys, manage the team, manage Portals and end users, or edit workspace settings and billing.
- Admins can do everything except transfer ownership or delete the workspace. Owners have full control.

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:

Check the authorized domains. Open the Suite's Settings tab. If Only allow access on authorized URLs is switched on, make sure your website's domain is listed under Authorized URLs. Embeds will not load on domains that are not authorized.
Inspect the iframe code. Make sure the embed snippet was pasted correctly into your page's HTML without any extra characters or missing quotes.

Troubleshooting

On this page