kestra-io/kestra · error · KestraRuntimeException

Invalid configuration for %s '%s'. Error: '%s'

Error message

Invalid configuration for %s '%s'. Error: '%s'

What it means

Error "Invalid configuration for %s '%s'. Error: '%s'" thrown in kestra-io/kestra.

Source

Thrown at core/src/main/java/io/kestra/core/plugins/AbstractPluginInterfaceFactory.java:128

            plugin = (T) JacksonMapper.toMap(nonEmptyConfig, pluginClass);
        } catch (Exception e) {
            throw new KestraRuntimeException(
                String.format("Failed to create %s '%s'. Error: %s", configDisplayName(), pluginId, e.getMessage())
            );
        }

        // Validate configuration.
        Set<ConstraintViolation<T>> violations;
        try {
            violations = validator.validate(plugin);
        } catch (ConstraintViolationException e) {
            throw new KestraRuntimeException(
                String.format("Failed to validate configuration for %s '%s'. Error: %s", configDisplayName(), pluginId, e.getMessage())
            );
        }
        if (!violations.isEmpty()) {
            ConstraintViolationException e = new ConstraintViolationException(violations);
            throw new KestraRuntimeException(
                String.format("Invalid configuration for %s '%s'. Error: '%s'", configDisplayName(), pluginId, e.getMessage()), e
            );
        }

        return plugin;
    }

    /**
     * Builds the exception thrown when no plugin matches the requested id. Overridable so subclasses
     * can enrich the message (e.g. EE surfacing a license-gated type as "installed but not enabled").
     *
     * @param pluginId the requested (unmatched) plugin id.
     * @return the exception to throw.
     */
    protected KestraRuntimeException notFoundException(final String pluginId) {
        return new KestraRuntimeException(
            "No %s can be found for '%s=%s'. Supported types are: %s".formatted(
                lookupDisplayName(), typeProperty(), pluginId, getLoggableTypeIds()

View on GitHub (pinned to 823fada927)

Solutions

1. Read the validation error detail in the message to identify the offending property, then correct the plugin configuration in your flow or Kestra configuration.
2. Check the plugin's documentation for required and allowed configuration properties, and remove unknown or mis-typed properties.

When it happens

Trigger: Thrown at core/src/main/java/io/kestra/core/plugins/AbstractPluginInterfaceFactory.java:128 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/9c89b16217a97a4f. Report an issue: GitHub.