Add runner scope

POST

/api/v4/runner_controllers/{id}/scopes/runners/{runner_id}

• GitLab REST API

Adds a runner scope to a runner controller. When added, the runner controller evaluates jobs only for a specified runner. A runner controller with an instance scope cannot have runner scopes. Remove the instance scope before adding runner scopes.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

integer

ID of the runner controller

runner_id

required

integer

ID of the runner

Responses

201

Created

Media typeapplication/json

object

runner_id

integer format: int64

created_at

string format: date-time

updated_at

string format: date-time

Example^generated

{
  "runner_id": 1,
  "created_at": "2026-04-15T12:00:00Z",
  "updated_at": "2026-04-15T12:00:00Z"
}

400

Bad Request

403

Forbidden

404

Not found

409

Conflict

422

Unprocessable Entity