kestra-io/kestra · error · IllegalStateException

Cannot execute a flow which is disabled

Error message

Cannot execute a flow which is disabled

What it means

Error "Cannot execute a flow which is disabled" thrown in kestra-io/kestra.

Source

Thrown at core/src/main/java/io/kestra/core/runners/ExecutableUtils.java:195

                    currentExecution.getTenantId(),
                    subflowNamespace,
                    subflowId,
                    subflowRevision,
                    currentExecution.getTenantId(),
                    currentFlow.getNamespace(),
                    currentFlow.getId()
                )
                    .orElseThrow(() ->
                    {
                        String msg = "Unable to find flow '" + subflowNamespace + "'.'" + subflowId + "' with revision '" + subflowRevision.orElse(0) + "'";
                        runContext.logger().error(msg);
                        return new IllegalStateException(msg);
                    });

                if (flow.isDisabled()) {
                    String msg = "Cannot execute a flow which is disabled";
                    runContext.logger().error(msg);
                    throw new IllegalStateException(msg);
                }

                if (flow instanceof FlowWithException fwe) {
                    String msg = "Cannot execute an invalid flow: " + fwe.getException();
                    runContext.logger().error(msg);
                    throw new IllegalStateException(msg);
                }

                List<Label> newLabels = inheritLabels ? new ArrayList<>(filterLabels(currentExecution.getLabels(), flow)) : new ArrayList<>(systemLabels(currentExecution));
                if (labels != null) {
                    labels.forEach(throwConsumer(label -> newLabels.add(new Label(runContext.render(label.key()), runContext.render(label.value())))));
                }

                var variables = ImmutableMap.<String, Object> builder().putAll(
                    Map.of(
                        "executionId", currentExecution.getId(),
                        "namespace", currentFlow.getNamespace(),
                        "flowId", currentFlow.getId(),

View on GitHub (pinned to 823fada927)

Solutions

1. Enable the flow (remove or set 'disabled: false') before executing it.
2. If the disable was intentional, choose a different, enabled flow to execute.

When it happens

Trigger: Thrown at core/src/main/java/io/kestra/core/runners/ExecutableUtils.java:195 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of kestra-io/kestra@823fada927 (2026-08-14). Data as JSON: /api/errors/c55c260a84b3a0fc. Report an issue: GitHub.