hashicorp/nomad · error

Missing job ID

Error message

Missing job ID

What it means

This error comes from the Job.Validate() method in HashiCorp Nomad's structs package. It is appended to a multierror when a submitted Job spec has an empty ID field. The Job ID is the primary identifier used by the Nomad scheduler and API to track the job, so it is mandatory.

Source

Thrown at nomad/structs/structs.go:4744

		}
		nj.TaskGroups = tgs
	}

	nj.Periodic = j.Periodic.Copy()
	nj.Meta = maps.Clone(j.Meta)
	nj.ParameterizedJob = j.ParameterizedJob.Copy()
	return nj
}

// Validate is used to check a job for reasonable configuration
func (j *Job) Validate() error {
	var mErr multierror.Error

	if j.Region == "" && j.Multiregion == nil {
		mErr.Errors = append(mErr.Errors, errors.New("Missing job region"))
	}
	if j.ID == "" {
		mErr.Errors = append(mErr.Errors, errors.New("Missing job ID"))
	} else if strings.Contains(j.ID, " ") {
		mErr.Errors = append(mErr.Errors, errors.New("Job ID contains a space"))
	} else if strings.Contains(j.ID, "\000") {
		mErr.Errors = append(mErr.Errors, errors.New("Job ID contains a null character"))
	}
	if j.Name == "" {
		mErr.Errors = append(mErr.Errors, errors.New("Missing job name"))
	} else if strings.Contains(j.Name, "\000") {
		mErr.Errors = append(mErr.Errors, errors.New("Job Name contains a null character"))
	}

	if j.Namespace == "" {
		mErr.Errors = append(mErr.Errors, errors.New("Job must be in a namespace"))
	}
	switch j.Type {
	case JobTypeCore, JobTypeService, JobTypeBatch, JobTypeSystem, JobTypeSysBatch:
	case "":
		mErr.Errors = append(mErr.Errors, errors.New("Missing job type"))

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Set an explicit `id` field in your job HCL/JSON, e.g. `id = "my-app"`
2. If relying on the default, ensure the job `name` is set so Nomad can derive an ID (jobs submitted via /v1/jobs default ID to name server-side only in some paths — set both explicitly)
3. When building jobs programmatically, assign job.ID before calling Validate() or the register endpoint

Example fix

// before
job "" {
  ...
}
// after
job "web-app" {
  ...
}

if j.ID == "" {
    return fmt.Errorf("job ID must be set before submission")
}

func hasJobID(j *structs.Job) bool { return j != nil && j.ID != "" }

if err := job.Validate(); err != nil {
    var mErr multierror.Error
    if errors.As(err, &mErr) {
        for _, e := range mErr.Errors {
            if strings.Contains(e.Error(), "Missing job ID") { /* fix ID */ }
        }
    }
}

When it happens

Trigger: Calling the Nomad HTTP API (POST /v1/jobs) or nomad job run with a job HCL/JSON whose top-level 'id' (or 'name' when id is omitted and not defaulted) is the empty string, or constructing a structs.Job in Go and calling Validate() with j.ID == "".

Common situations: HCL job files that set only 'name' while templating produces an empty id field; programmatic job generation where the ID template variable renders empty; accidentally passing an empty string to a job struct in Go code.

Understand the failure class

Background: "missing required argument" and "the following required arguments were not provided": what required-argument errors mean and how to fix them — this error's family across 20 libraries.

Related errors

• Job ID contains a space
• Missing job name
• Missing job type
• Missing job task groups
• Disconnect cannot be configured with both lost_after and sto

AI-assisted analysis of hashicorp/nomad@482b49bf1a (2026-09-04). Data as JSON: /api/errors/9d8ea5b9faff6cdd. Report an issue: GitHub.