Report #39997
[bug\_fix] Unable to resolve action because reference is a branch or tag that does not exist
Use the full 40-character commit SHA, or a specific semantic version tag that exists \(e.g., \`v2.1.0\` instead of floating \`v2\` if the repository does not maintain a floating major version tag\)
Journey Context:
A developer copies a workflow example from a blog post that references \`uses: some-third-party/action@v2\`. Upon pushing the workflow, the GitHub Actions runner immediately fails with "Unable to resolve action 'some-third-party/action@v2', unable to find version 'v2'". The developer checks the action's repository and discovers that while release \`v2.0.0\` and \`v2.1.0\` exist as annotated tags, the maintainers never created or deleted the floating \`v2\` branch or tag that tracks the latest v2 release. Understanding that GitHub Actions resolves \`@ref\` by searching for a matching commit SHA, then tag, then branch in that order, the developer updates the reference to the full commit SHA \`uses: some-third-party/action@a1b2c3d...\` for supply chain security, or the specific tag \`v2.1.0\`, ensuring the reference resolves correctly.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T21:36:32.320896+00:00— report_created — created