colpal/actions-find-artifact-by-ref

Find a workflow artifact for a particular ref

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit Jul 9, 2026
License: GPL 3.0

Pinned Snippet

workflow.ymlSHA-pinned

uses: colpal/actions-find-artifact-by-ref@d16e5d29aecb2fb7582a2f291c1c255b1a189898 # v2.3.1

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
ref	Only search workflows on this git ref	yes	—
artifact_name	Only match artifacts with this name	yes	—
download	If set, will download the matched artifact	no	false
on_duplicate	Define what to do if multiple matching artifacts are found. The possible options are: - error: Fail immediately - newest: Use the newest matching artifact - oldest: Use the oldest matching artifact	no	error
github_token	The GitHub token used to create an authenticated client	no	${{ github.token }}
run_name	The name of the run that generated the artifact. This can help narrow the number of workflow runs that are considered, reducing the chance of artifact name collisions and reducing the number of necessary API calls. If not provided, all workflow runs for the provided ref will be considered. The run name will generally match the job name, but can include additional text if the job run was part of a `matrix` or a reusable workflow	no	""

Outputs

name	description
error	An error code if the action fails (mostly for testing)
artifact_id	The artifact ID of the found artifact