.nh
.TH "glab" "1" "Sep 2026" "Auto generated by spf13/cobra" ""

.SH NAME
glab-artifact-registry-status - Check your access to the GitLab Artifact Registry. (EXPERIMENTAL)


.SH SYNOPSIS
\fBglab artifact-registry status [flags]\fP


.SH DESCRIPTION
Exchange a GitLab credential for a short-lived Artifact Registry access
token, then print the token's issuer, subject, audience, and expiry so
you can confirm which identity and instance you are authenticated as. No
credentials are written to disk.

.PP
Prerequisites:
.IP \(bu 2
A GitLab Enterprise Edition (EE) instance on GitLab 19.1 or later.
.IP \(bu 2
Token exchange enabled on the instance (the
\fBgate_token_exchange_endpoint\fR feature flag).

.PP
This feature is an experiment and is not ready for production use.
It might be unstable or removed at any time.
For more information, see
https://docs.gitlab.com/policy/development_stages_support/.


.SH OPTIONS
\fB--hostname\fP=""
	GitLab hostname to check. Defaults to the configured GitLab instance.

.PP
\fB--jq\fP=""
	Filter JSON output with a jq expression.

.PP
\fB-F\fP, \fB--output\fP="text"
	Format output as: text, json.


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB-h\fP, \fB--help\fP[=false]
	Show help for this command.


.SH EXAMPLE
.EX
# Show Artifact Registry access status
glab artifact-registry status

# Show Artifact Registry access status as JSON
glab artifact-registry status --output json

.EE


.SH SEE ALSO
\fBglab-artifact-registry(1)\fP