argoproj/argo-workflows · error

[%d].name: '%s' is invalid: %s

Error message

[%d].name: '%s' is invalid: %s

What it means

validateWorkflowFieldNames found a name that fails the regex check — either the param/artifact regex or the workflow-field regex depending on context. The message carries the index, the offending name, and the specific rule(s) violated (e.g. illegal characters, wrong case).

Source

Thrown at pkg/apis/workflow/v1alpha1/validation_utils.go:63

// verifies that the Name field of the structs are:
// * unique
// * non-empty
// * matches matches our regex requirements
func validateWorkflowFieldNames(names []string, isParamOrArtifact bool) error {
	nameSet := make(map[string]bool)

	for i, name := range names {
		if name == "" {
			return fmt.Errorf("[%d].name is required", i)
		}
		var errs []string
		if isParamOrArtifact {
			errs = isValidParamOrArtifactName(name)
		} else {
			errs = isValidWorkflowFieldName(name)
		}
		if len(errs) != 0 {
			return fmt.Errorf("[%d].name: '%s' is invalid: %s", i, name, strings.Join(errs, ";"))
		}
		_, ok := nameSet[name]
		if ok {
			return fmt.Errorf("[%d].name '%s' is not unique", i, name)
		}
		nameSet[name] = true
	}
	return nil
}

// validateNoCycles validates that a dependency graph has no cycles by doing a Depth-First Search
// depGraph is an adjacency list, where key is a node name and value is a list of its dependencies' names
func validateNoCycles(depGraph map[string][]string) error {
	visited := make(map[string]bool)
	var noCyclesHelper func(currentName string, cycyle []string) error
	noCyclesHelper = func(currentName string, cycle []string) error {
		if _, ok := visited[currentName]; ok {
			return nil

View on GitHub (pinned to 35bff19146)

Solutions

1. Rename to match the allowed pattern (e.g. My-name1-2 for fields; alphanumeric plus '-' and '_' for params/artifacts)
2. Check the joined error details for the exact rule violated

When it happens

Trigger: Thrown at pkg/apis/workflow/v1alpha1/validation_utils.go:63 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of argoproj/argo-workflows@35bff19146 (2026-09-03). Data as JSON: /api/errors/dad9b685cb568dcc. Report an issue: GitHub.