.nh
.TH "GH-RELEASE-VERIFY" "1" "Oct 2025" "" "GitHub CLI manual"

.SH NAME
gh-release-verify - Verify the attestation for a release


.SH SYNOPSIS
\fBgh release verify [<tag>] [flags]\fR


.SH DESCRIPTION
Verify that a GitHub Release is accompanied by a valid cryptographically signed attestation.

.PP
An attestation is a claim made by GitHub regarding a release and its assets.

.PP
This command checks that the specified release (or the latest release, if no tag is given) has a valid attestation.
It fetches the attestation for the release and prints metadata about all assets referenced in the attestation, including their digests.


.SH OPTIONS
.TP
\fB--format\fR \fB<string>\fR
Output format: {json}

.TP
\fB-q\fR, \fB--jq\fR \fB<expression>\fR
Filter JSON output using a jq expression

.TP
\fB-t\fR, \fB--template\fR \fB<string>\fR
Format JSON output using a Go template; see "gh help formatting"


.SH OPTIONS INHERITED FROM PARENT COMMANDS
.TP
\fB-R\fR, \fB--repo\fR \fB<[HOST/]OWNER/REPO>\fR
Select another repository using the [HOST/]OWNER/REPO format


.SH EXIT CODES
0: Successful execution

.PP
1: Error

.PP
2: Command canceled

.PP
4: Authentication required

.PP
NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.


.SH EXAMPLE
.EX
# Verify the latest release
gh release verify

# Verify a specific release by tag
gh release verify v1.2.3

# Verify a specific release by tag and output the attestation in JSON format
gh release verify v1.2.3 --format json

.EE


.SH SEE ALSO
\fBgh-release(1)\fR