kestra-io/kestra · error · IllegalStateException

Unable to find flow '{}.{}' with revision {} on execution {}

Error message

Unable to find flow '{}.{}' with revision {} on execution {}

What it means

Error "Unable to find flow '{}.{}' with revision {} on execution {}" thrown in kestra-io/kestra.

Source

Thrown at core/src/main/java/io/kestra/core/repositories/FlowRepositoryInterface.java:61

            .flatMap(Collection::stream)
            .toList();
        return namespaces.stream().anyMatch(ns -> ns.equals(namespace) || ns.startsWith(namespace));
    }

    /**
     * Used only if result is used internally and not exposed to the user.
     * It is useful when we want to restart/resume a flow.
     */
    default FlowWithSource findByExecutionWithoutAcl(Execution execution) {
        Optional<FlowWithSource> find = this.findByIdWithSourceWithoutAcl(
            execution.getTenantId(),
            execution.getNamespace(),
            execution.getFlowId(),
            Optional.ofNullable(execution.getFlowRevision())
        );

        if (find.isEmpty()) {
            throw new IllegalStateException(
                "Unable to find flow '" + execution.getNamespace() + "." +
                    execution.getFlowId() + "' with revision " + execution.getFlowRevision() + " on execution " +
                    execution.getId()
            );
        } else {
            return find.get();
        }
    }

    default Flow findByExecution(Execution execution) {
        Optional<Flow> find = this.findById(
            execution.getTenantId(),
            execution.getNamespace(),
            execution.getFlowId(),
            Optional.ofNullable(execution.getFlowRevision())
        );

        if (find.isEmpty()) {

View on GitHub (pinned to 823fada927)

Solutions

1. Verify the namespace and flow id in the message exist, and that the requested revision is a valid revision of that flow.
2. Omit the revision to use the latest revision, or correct the revision number to one that exists.

When it happens

Trigger: Thrown at core/src/main/java/io/kestra/core/repositories/FlowRepositoryInterface.java:61 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/9fa7a659547e7cc9. Report an issue: GitHub.