kestra-io/kestra · error · IllegalArgumentException

Bad artifact coordinates {}, expected format is <groupId>:<a

Error message

Bad artifact coordinates {}, expected format is <groupId>:<artifactId>[:<extension>[:<classifier>]]:<version>

What it means

Error "Bad artifact coordinates {}, expected format is <groupId>:<artifactId>[:<extension>[:<classifier>]]:<version>" thrown in kestra-io/kestra.

Source

Thrown at core/src/main/java/io/kestra/core/plugins/PluginArtifact.java:82

                artifactId,
                "jar",
                null,
                version,
                file.toURI()
            );
        }
    }

    /**
     * Static helper method for constructing a new {@link PluginArtifact} from an artifact string coordinates.
     *
     * @param coordinates The artifact's coordinates
     * @return a new {@link PluginArtifact}.
     */
    public static PluginArtifact fromCoordinates(final String coordinates) {
        Matcher m = ARTIFACT_PATTERN.matcher(coordinates);
        if (!m.matches()) {
            throw new IllegalArgumentException(
                "Bad artifact coordinates " + coordinates
                    + ", expected format is <groupId>:<artifactId>[:<extension>[:<classifier>]]:<version>"
            );
        }
        return new PluginArtifact(
            m.group(1),
            m.group(2),
            Optional.ofNullable(m.group(4)).filter(not(String::isEmpty)).orElse(JAR_EXTENSION),
            Optional.ofNullable(m.group(6)).filter(not(String::isEmpty)).orElse(null),
            "LATEST".equalsIgnoreCase(m.group(7)) ? "LATEST" : m.group(7),
            null
        );
    }

    /**
     * Static helper method for constructing a new {@link PluginArtifact} from an artifact a file name.
     *
     * @param fileName The artifact's file name

View on GitHub (pinned to 823fada927)

Solutions

1. Rewrite the artifact coordinates in the format <groupId>:<artifactId>[:<extension>[:<classifier>]]:<version>, e.g. io.kestra.plugin:plugin-jdbc:1.0.0.

When it happens

Trigger: Thrown at core/src/main/java/io/kestra/core/plugins/PluginArtifact.java:82 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/7d25334a2d152e29. Report an issue: GitHub.