CircleCI "Error calling workflow" - Job Not Found

By Daniel Zoghalchali·Latchkey

A workflow or a requires: dependency references a job CircleCI cannot find. The workflow graph does not line up with the jobs: map, so validation fails.

What this error means

Validation fails with "Error calling workflow" / "Error calling job" naming the job it could not resolve. The pipeline is rejected because the graph references something that does not exist.

Error calling workflow: "ci"
Error calling job: "deploy"
Job not defined: "build-and-test"
Error: config compilation contains errors

Common causes

requires names a missing job

requires: [build-and-test] must reference a job present in the same workflow. A typo or a removed job breaks the dependency graph.

Workflow references an undefined job

A job under workflows.<name>.jobs has no matching jobs: entry or orb job, so the workflow cannot be assembled.

How to fix it

Make requires reference real jobs

workflows:
  ci:
    jobs:
      - build-and-test
      - deploy:
          requires: [build-and-test]

Use aliases consistently

1. If a job has a name: alias, reference that alias in requires:.
2. For matrix jobs, reference the generated alias, not the base name.
3. Validate config to confirm the graph resolves.

How to prevent it

• Keep workflow job names in sync with the jobs: keys.
• Validate config on every PR so a broken graph fails before merge.
• Avoid copy-pasting requires: without updating names.

Frequently asked questions

Related guides

References

• GitHub Actions documentation