gitlab-org--gitlab-foss/doc/ci/api/runners.md

Runners API

Note: This API is intended to be used only by Runners as their own communication channel. For the consumer API see the new Runners API.

Runners

Retrieve all runners

Authentication is done by GitLab user token & GitLab url

Used to get information about all runners registered on the GitLab CI instance.

GET /ci/runners

Returns:

[
  {
    "id" : 85,
    "token" : "12b68e90394084703135"
  },
  {
    "id" : 86,
    "token" : "76bf894e969364709864"
  },
]

Register a new runner

Authentication is done with a Shared runner registration token or a project Specific runner registration token

Used to make GitLab CI aware of available runners.

POST /ci/runners/register

Parameters:

• token (required) - The registration token. It is 2 types of token you can pass here.

1. Shared runner registration token
2. Project specific registration token

Returns:

{
  "id" : 85,
  "token" : "12b68e90394084703135"
}

Delete a runner

Authentication is done by runner token

Used to removing runners.

DELETE /ci/runners/delete

Parameters:

• token (required) - The runner token.

Returns:

{
  "id" : 1,
  "token" : "d14963981a428f70121777e50643d1",
  "created_at" : "2015-02-26T11:39:39.232Z",
  "updated_at" : "2015-02-26T11:39:39.232Z",
  "description" : "awesome runner"
}