Add instance scope
POST
/api/v4/runner_controllers/{id}/scopes/instance
Adds an instance scope to a runner controller. When added, the runner controller evaluates jobs for all runners in the GitLab instance. A runner controller can have only one instance scope. If an instance scope already exists, this operation returns an error.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
integer
ID of the runner controller
Responses
Section titled “Responses”Created
Media typeapplication/json
object
created_at
string format: date-time
updated_at
string format: date-time
Examplegenerated
{ "created_at": "2026-04-15T12:00:00Z", "updated_at": "2026-04-15T12:00:00Z"}Bad Request
Forbidden
Not found
Conflict