Skip to main content

Troubleshooting

Common issues and quick checks when building and running workflows.

I can’t edit the workflow​

Symptoms:

  • The builder panel is missing
  • You can view but not modify nodes/edges

Checks:

  • Verify you have permission to update the workflow.

See: Workflow permissions

The Run button is missing​

Checks:

  • Verify you have permission to execute workflows.
  • Confirm you’re viewing a workflow in the workflows UI.

The run looks “stuck” / no progress updates​

What’s happening:

  • Workflow runs are executed asynchronously.
  • The current UI does not expose real-time progress streaming (SSE) for workflow runs.

What to do:

  • Refresh the run list or re-open the History view to update statuses.
  • If a run remains RUNNING for a long time, check backend logs/monitoring.

Variables aren’t being replaced​

Checks:

  • Ensure your placeholder matches the input parameter name exactly: {{my_param}}.
  • Confirm the input parameter exists in the Input node.

I can’t create an input parameter with a certain name​

Workflows reserve some parameter names (built-in task parameters), for example:

  • user_context

Use a different parameter name.

Attachments aren’t appearing in run details​

Checks:

  • Confirm you added attachments during Run.
  • Confirm you have permission to view the workflow run details.

“Continue to Assistant Chat” is disabled or missing​

Checks:

  • Ensure the workflow has a linked assistant, or select one when prompted.
  • Confirm you can view the workflow run.
  • Confirm you have access to the assistant.

See: Assistant integration