Add runner scope
POST
/api/v4/runner_controllers/{id}/scopes/runners/{runner_id}
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
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ” id
required
integer
ID of the runner controller
runner_id
required
integer
ID of the runner
Responses
Section titled “ Responses ”Created
Media type application/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"}Bad Request
Forbidden
Not found
Conflict
Unprocessable Entity