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

.SH NAME
glab-runner-controller-scope-create - Create a scope for a runner controller. (EXPERIMENTAL)


.SH SYNOPSIS
\fBglab runner-controller scope create  [flags]\fP


.SH DESCRIPTION
Create a scope for a runner controller. This is an admin-only feature.

.PP
Currently, only instance-level scopes are supported. Use the --instance flag
to add an instance-level scope, which allows the runner controller to evaluate
jobs for all runners in the GitLab instance.

.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--instance\fP[=false]
	Add an instance-level scope.

.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
# Add an instance-level scope to runner controller 42
$ glab runner-controller scope create 42 --instance

# Add an instance-level scope and output as JSON
$ glab runner-controller scope create 42 --instance --output json

.EE


.SH SEE ALSO
\fBglab-runner-controller-scope(1)\fP