Skip to content

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.

id
required
integer

ID of the runner controller

Created

Media type application/json
object
created_at
string format: date-time
updated_at
string format: date-time
Example generated
{
"created_at": "2026-04-15T12:00:00Z",
"updated_at": "2026-04-15T12:00:00Z"
}

Bad Request

Forbidden

Not found

Conflict