Runners

Use this API to manage the runners already registered to an instance, group, or project.

To create a runner, use the POST /user/runners endpoint instead.

List all runners in a group

GET /api/v4/groups/{id}/runners

Lists all runners available in a specified group and any ancestor groups, including any allowed instance runners.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the group
`type` Query	String	Type of runners to return Allowed values: `instance_type`, `group_type`, `project_type`
`paused` Query	Boolean	If `true`, returns only runners that are ignoring new jobs. If `false`, returns only runners that are accepting new jobs
`status` Query	String	Status of runners to return Allowed values: `active`, `paused`, `online`, `offline`, `never_contacted`, `stale`
`tag_list` Query	Array of strings	List of runner tags Example: `["macos","shell"]`
`version_prefix` Query	String	Version prefix of runners to return Pattern: `(?<=^\|\n(?!$))[\d+.]+` Example: `15.1.`
`page` Query	Integer	Page number of results to retrieve Default: `1` Example: `1`
`per_page` Query	Integer	Number of items to list per page Default: `20` Example: `20`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesCiRunner
`400`	Scope contains invalid value	—
`403`	Forbidden	—
`404`	Not Found	—

Reset runner registration token

POST /api/v4/groups/{id}/runners/reset_registration_token

FE version

Parameters

Name	Type	Description
`id` Path, required	String	The ID of a group

Responses

Code	Description	Schema
`201`	Created	APIEntitiesCiResetTokenResult
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Group Not Found	—

List all runners for a project

GET /api/v4/projects/{id}/runners

List all runners available in the project, including from ancestor groups and any allowed shared runners.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`scope` Query	String	Scope of runners to return. Deprecated. Use `type` or `status` instead Allowed values: `specific`, `shared`, `instance_type`, `group_type`, `project_type`, `active`, `paused`, `online`, `offline`, `never_contacted`, `stale`
`type` Query	String	Type of runners to return Allowed values: `instance_type`, `group_type`, `project_type`
`paused` Query	Boolean	If `true`, returns only runners that are ignoring new jobs. If `false`, returns only runners that are accepting new jobs
`status` Query	String	Status of runners to return Allowed values: `active`, `paused`, `online`, `offline`, `never_contacted`, `stale`
`tag_list` Query	Array of strings	List of runner tags Example: `["macos","shell"]`
`version_prefix` Query	String	Version prefix of runners to return Pattern: `(?<=^\|\n(?!$))[\d+.]+` Example: `15.1.`
`page` Query	Integer	Page number of results to retrieve Default: `1` Example: `1`
`per_page` Query	Integer	Number of items to list per page Default: `20` Example: `20`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesCiRunner
`400`	Scope contains invalid value	—
`403`	No access granted	—
`404`	Not Found	—

Assign a runner to a project

POST /api/v4/projects/{id}/runners

Assigns an available project runner to a project.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project

Request body (application/json)

Property	Type	Description
`runner_id` Required	Integer	ID of the runner

Responses

Code	Description	Schema
`201`	Created	APIEntitiesCiRunner
`400`	Bad Request	—
`403`	Runner is locked	—
`404`	Runner not found	—

Reset runner registration token

POST /api/v4/projects/{id}/runners/reset_registration_token

FE version

Parameters

Name	Type	Description
`id` Path, required	String	The ID of a project

Responses

Code	Description	Schema
`201`	Created	APIEntitiesCiResetTokenResult
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Project Not Found	—

Unassign a runner from a project

DELETE /api/v4/projects/{id}/runners/{runner_id}

Unassigns a specified project runner from a project. You cannot unassign a runner from the owner project. Use the delete a runner operation instead.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`runner_id` Path, required	Integer	ID of the runner

Responses

Code	Description	Schema
`200`	OK	APIEntitiesCiRunner
`400`	Bad Request	—
`403`	You cannot unassign a runner from the owner project. Delete the runner instead	—
`404`	Runner not found	—
`412`	Precondition Failed	—

List all available runners

GET /api/v4/runners

Lists all runners available to the user. For group runners, you must have the Owner role in the owner namespace.

Parameters

Name	Type	Description
`scope` Query	String	Scope of runners to return. Deprecated. Use `type` or `status` instead Allowed values: `specific`, `shared`, `instance_type`, `group_type`, `project_type`, `active`, `paused`, `online`, `offline`, `never_contacted`, `stale`
`type` Query	String	Type of runners to return Allowed values: `instance_type`, `group_type`, `project_type`
`paused` Query	Boolean	If `true`, returns only runners that are ignoring new jobs. If `false`, returns only runners that are accepting new jobs
`status` Query	String	Status of runners to return Allowed values: `active`, `paused`, `online`, `offline`, `never_contacted`, `stale`
`tag_list` Query	Array of strings	List of runner tags Example: `["macos","shell"]`
`version_prefix` Query	String	Version prefix of runners to return Pattern: `(?<=^\|\n(?!$))[\d+.]+` Example: `15.1.`
`page` Query	Integer	Page number of results to retrieve Default: `1` Example: `1`
`per_page` Query	Integer	Number of items to list per page Default: `20` Example: `20`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesCiRunner
`400`	Scope contains invalid value	—
`401`	Unauthorized	—

List all runners

GET /api/v4/runners/all

Lists all runners in the GitLab instance (project and shared). You must have either administrator access or auditor access.

Parameters

Name	Type	Description
`scope` Query	String	Scope of runners to return. Deprecated. Use `type` or `status` instead Allowed values: `specific`, `shared`, `instance_type`, `group_type`, `project_type`, `active`, `paused`, `online`, `offline`, `never_contacted`, `stale`
`type` Query	String	Type of runners to return Allowed values: `instance_type`, `group_type`, `project_type`
`paused` Query	Boolean	If `true`, returns only runners that are ignoring new jobs. If `false`, returns only runners that are accepting new jobs
`status` Query	String	Status of runners to return Allowed values: `active`, `paused`, `online`, `offline`, `never_contacted`, `stale`
`tag_list` Query	Array of strings	List of runner tags Example: `["macos","shell"]`
`version_prefix` Query	String	Version prefix of runners to return Pattern: `(?<=^\|\n(?!$))[\d+.]+` Example: `15.1.`
`page` Query	Integer	Page number of results to retrieve Default: `1` Example: `1`
`per_page` Query	Integer	Number of items to list per page Default: `20` Example: `20`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesCiRunner
`400`	Scope contains invalid value	—
`401`	Unauthorized	—

Reset the runner registration token for the instance

POST /api/v4/runners/reset_registration_token

Resets the runner registration token for the GitLab instance.

Responses

Code	Description	Schema
`201`	Created	APIEntitiesCiResetTokenResult
`400`	Bad Request	—
`403`	Forbidden	—

Retrieve details on a runner

GET /api/v4/runners/{id}

Retrieves details of a runner. Instance runner details are available to all authenticated users through this endpoint. For groups and projects, you must have the Maintainer or Owner role for the associated project or group.

Parameters

Name	Type	Description
`id` Path, required	Integer	ID of the runner
`include_projects` Query	Boolean	If `true`, includes projects in the response. If `false`, improves performance for runners with many projects Default: `true`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesCiRunnerDetails
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	No access granted	—
`404`	Runner not found	—

Update a runner

PUT /api/v4/runners/{id}

Updates a specified runner.

Parameters

Name	Type	Description
`id` Path, required	Integer	ID of the runner

Request body (application/json)

Property	Type	Description
`access_level`	String	Access level of the runner. At least one of `description`, `active`, `paused`, `tag_list`, `run_untagged`, `locked`, `access_level`, `maximum_timeout`, `maintenance_note` must be provided Allowed values: `not_protected`, `ref_protected`
`active`	Boolean	If `true`, the runner is allowed to receive jobs. Deprecated. Use `paused` instead. Mutually exclusive with `paused`. At least one of `description`, `active`, `paused`, `tag_list`, `run_untagged`, `locked`, `access_level`, `maximum_timeout`, `maintenance_note` must be provided
`description`	String	Description of the runner. At least one of `description`, `active`, `paused`, `tag_list`, `run_untagged`, `locked`, `access_level`, `maximum_timeout`, `maintenance_note` must be provided
`locked`	Boolean	If `true`, the runner is locked. At least one of `description`, `active`, `paused`, `tag_list`, `run_untagged`, `locked`, `access_level`, `maximum_timeout`, `maintenance_note` must be provided
`maintenance_note`	String	Free-form maintenance notes for the runner. Limited to 1024 characters. At least one of `description`, `active`, `paused`, `tag_list`, `run_untagged`, `locked`, `access_level`, `maximum_timeout`, `maintenance_note` must be provided
`maximum_timeout`	Integer	Maximum time, in seconds, that runners can spend running a job. At least one of `description`, `active`, `paused`, `tag_list`, `run_untagged`, `locked`, `access_level`, `maximum_timeout`, `maintenance_note` must be provided
`paused`	Boolean	If `true`, the runner ignores new jobs. Mutually exclusive with `active`. At least one of `description`, `active`, `paused`, `tag_list`, `run_untagged`, `locked`, `access_level`, `maximum_timeout`, `maintenance_note` must be provided
`run_untagged`	Boolean	If `true`, the runner can execute untagged jobs. At least one of `description`, `active`, `paused`, `tag_list`, `run_untagged`, `locked`, `access_level`, `maximum_timeout`, `maintenance_note` must be provided
`tag_list`	Array of strings	List of tags for the runner. At least one of `description`, `active`, `paused`, `tag_list`, `run_untagged`, `locked`, `access_level`, `maximum_timeout`, `maintenance_note` must be provided

Responses

Code	Description	Schema
`200`	OK	APIEntitiesCiRunnerDetails
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	No access granted	—
`404`	Runner not found	—

Delete a runner

DELETE /api/v4/runners/{id}

Deletes a specified runner.

Parameters

Name	Type	Description
`id` Path, required	Integer	ID of the runner

Responses

Code	Description	Schema
`200`	OK	APIEntitiesCiRunner
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Runner associated with more than one project	—
`404`	Runner not found	—
`412`	Precondition Failed	—

List all jobs processed by a runner

GET /api/v4/runners/{id}/jobs

Lists all jobs that are being processed or were processed by a specified runner. The list of jobs is limited to projects where the user has the Reporter, Developer, Maintainer, or Owner role.

Parameters

Name	Type	Description
`id` Path, required	Integer	ID of the runner
`system_id` Query	String	System ID associated with the runner manager
`status` Query	String	Status of the job Allowed values: `created`, `waiting_for_resource`, `preparing`, `waiting_for_callback`, `pending`, `running`, `success`, `failed`, `canceling`, `canceled`, `skipped`, `manual`, `scheduled`
`order_by` Query	String	Sort results by the specified field Allowed values: `id`
`sort` Query	String	Sort results in ascending or descending order. Specify `order_by` as well, including for `id` Allowed values: `asc`, `desc` Default: `desc`
`cursor` Query	String	Cursor for obtaining the next set of records
`page` Query	Integer	Page number of results to retrieve Default: `1` Example: `1`
`per_page` Query	Integer	Number of items to list per page Default: `20` Example: `20`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesCiJobBasicWithProject
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	No access granted	—
`404`	Runner not found	—

List all managers for a runner

GET /api/v4/runners/{id}/managers

List all managers for a specified runner.

Parameters

Name	Type	Description
`id` Path, required	Integer	ID of the runner

Responses

Code	Description	Schema
`200`	OK	APIEntitiesCiRunnerManager
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Get projects associated with a runner

GET /api/v4/runners/{id}/projects

Get a paginated list of all projects associated with the specified runner. Access is restricted based on user permissions.

Parameters

Name	Type	Description
`id` Path, required	Integer	ID of the runner
`page` Query	Integer	Page number of results to retrieve Default: `1` Example: `1`
`per_page` Query	Integer	Number of items to list per page Default: `20` Example: `20`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesBasicProjectDetails
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	No access granted	—
`404`	Runner not found	—

Reset an authentication token for a runner

POST /api/v4/runners/{id}/reset_authentication_token

Resets the authentication token for a specified runner.

Parameters

Name	Type	Description
`id` Path, required	Integer	ID of the runner

Responses

Code	Description	Schema
`201`	Created	APIEntitiesCiResetTokenResult
`400`	Bad Request	—
`403`	No access granted	—
`404`	Runner not found	—
`422`	Unprocessable Entity	—

Create a runner owned by currently authenticated user

POST /api/v4/user/runners

Create a new runner

Request body (application/json)

Property	Type	Description
`access_level`	String	Access level of the runner Allowed values: `not_protected`, `ref_protected`
`description`	String	Description of the runner
`group_id` Required	Integer	ID of the group to create the runner in. Required if `runner_type` is `group_type` Example: `1`
`locked`	Boolean	Specifies if the runner should be locked for the current project Default: `false`
`maintenance_note`	String	Free-form maintenance notes for the runner. Limited to 1024 characters
`maximum_timeout`	Integer	Maximum time, in seconds, that runners can spend running a job
`paused`	Boolean	If `true`, the runner ignores new jobs
`project_id` Required	Integer	ID of the project to create the runner in. Required if `runner_type` is `project_type` Example: `1`
`run_untagged`	Boolean	Specifies if the runner should handle untagged jobs Default: `true`
`runner_type` Required	String	Scope of the runner Allowed values: `instance_type`, `group_type`, `project_type` Minimum length: `1`
`tag_list`	Array of strings	Comma-separated list of runner tags

Responses

Code	Description	Schema
`201`	Created	APIEntitiesCiRunnerRegistrationDetails
`400`	Bad Request	—
`403`	Forbidden	—

Schemas

Objects returned by the operations above and objects nested in their request bodies.

APIEntitiesBasicGroupDetails

Property	Type	Description
`id`	Integer (int64)	—
`name`	String	Example: `Diaspora`
`web_url`	String	Example: `http://gitlab.example.com/groups/diaspora`

APIEntitiesBasicProjectDetails

Property	Type	Description
`avatar_url`	String	Example: `http://example.com/uploads/project/avatar/3/uploads/avatar.png`
`created_at`	String (date-time)	Example: `2020-05-07T04:27:17.016Z`
`custom_attributes`	APIEntitiesCustomAttribute	—
`default_branch`	String	Example: `main`
`description`	String	Example: `desc`
`forks_count`	Integer	Example: `1`
`http_url_to_repo`	String	Example: `https://gitlab.example.com/gitlab/gitlab.git`
`id`	Integer (int64)	Example: `1`
`last_activity_at`	String (date-time)	Example: `2013-09-30T13:46:02Z`
`license`	APIEntitiesLicenseBasic	—
`license_url`	String	Example: `https://gitlab.example.com/gitlab/gitlab/blob/master/LICENCE`
`name`	String	Example: `project1`
`name_with_namespace`	String	Example: `John Doe / project1`
`namespace`	APIEntitiesNamespaceBasic	—
`path`	String	Example: `project1`
`path_with_namespace`	String	Example: `namespace1/project1`
`readme_url`	String	Example: `https://gitlab.example.com/gitlab/gitlab/blob/master/README.md`
`repository_storage`	String	Example: `default`
`ssh_url_to_repo`	String	Example: `git@gitlab.example.com:gitlab/gitlab.git`
`star_count`	Integer	Example: `1`
`tag_list`	Array of strings	Example: `["tag"]`
`topics`	Array of strings	Example: `["topic"]`
`visibility`	String	Example: `public`
`web_url`	String	Example: `https://gitlab.example.com/gitlab/gitlab`

APIEntitiesCiJobBasicWithProject

Property	Type	Description
`allow_failure`	Boolean	—
`commit`	APIEntitiesCommit	—
`coverage`	Number (float)	Example: `98.29`
`created_at`	String (date-time)	Example: `2015-12-24T15:51:21.880Z`
`duration`	Number (float)	Time spent running Example: `0.465`
`erased_at`	String (date-time)	Example: `2015-12-24T18:00:29.728Z`
`failure_reason`	String	Example: `script_failure`
`finished_at`	String (date-time)	Example: `2015-12-24T17:54:31.198Z`
`id`	Integer (int64)	Example: `1`
`name`	String	Example: `deploy_to_production`
`pipeline`	APIEntitiesCiPipelineBasic	—
`project`	APIEntitiesProjectIdentity	—
`queued_duration`	Number (float)	Time spent enqueued Example: `0.123`
`ref`	String	Example: `main`
`stage`	String	Example: `deploy`
`started_at`	String (date-time)	Example: `2015-12-24T17:54:30.733Z`
`status`	String	Example: `waiting_for_resource`
`tag`	Boolean	—
`user`	APIEntitiesUser	—
`web_url`	String	Example: `https://example.com/foo/bar/-/jobs/1`

APIEntitiesCiPipelineBasic

Property	Type	Description
`created_at`	String (date-time)	Example: `2022-10-21T16:49:48.000+02:00`
`id`	Integer (int64)	Example: `1`
`iid`	Integer	Example: `2`
`project_id`	Integer (int64)	Example: `3`
`ref`	String	Example: `feature-branch`
`sha`	String	Example: `0ec9e58fdfca6cdd6652c083c9edb53abc0bad52`
`source`	String	Example: `push`
`status`	String	Example: `success`
`updated_at`	String (date-time)	Example: `2022-10-21T16:49:48.000+02:00`
`web_url`	String	Example: `https://gitlab.example.com/gitlab-org/gitlab-foss/-/pipelines/61`

APIEntitiesCiResetTokenResult

Property	Type	Description
`token`	String	—
`token_expires_at`	String	—

APIEntitiesCiRunner

Property	Type	Description
`active`	Boolean	Example: `true`
`created_at`	String (date-time)	Example: `2025-05-03T00:00:00.000Z`
`created_by`	APIEntitiesUserBasic	—
`description`	String	Example: `test-1-20150125`
`id`	Integer (int64)	Example: `8`
`ip_address`	String	Example: `127.0.0.1`
`is_shared`	Boolean	Example: `true`
`job_execution_status`	String	Allowed values: `active`, `idle` Example: `idle`
`name`	String	Example: `test`
`online`	Boolean	Example: `true`
`paused`	Boolean	Example: `false`
`runner_type`	String	Allowed values: `instance_type`, `group_type`, `project_type` Example: `instance_type`
`status`	String	Example: `online`

APIEntitiesCiRunnerDetails

Property	Type	Description
`access_level`	String	—
`active`	Boolean	Example: `true`
`architecture`	String	—
`contacted_at`	String	—
`created_at`	String (date-time)	Example: `2025-05-03T00:00:00.000Z`
`created_by`	APIEntitiesUserBasic	—
`description`	String	Example: `test-1-20150125`
`groups`	APIEntitiesBasicGroupDetails	—
`id`	Integer (int64)	Example: `8`
`ip_address`	String	Example: `127.0.0.1`
`is_shared`	Boolean	Example: `true`
`job_execution_status`	String	Allowed values: `active`, `idle` Example: `idle`
`locked`	String	—
`maintenance_note`	String	—
`maximum_timeout`	String	—
`name`	String	Example: `test`
`online`	Boolean	Example: `true`
`paused`	Boolean	Example: `false`
`platform`	String	—
`projects`	APIEntitiesBasicProjectDetails	—
`revision`	String	—
`run_untagged`	String	—
`runner_type`	String	Allowed values: `instance_type`, `group_type`, `project_type` Example: `instance_type`
`status`	String	Example: `online`
`tag_list`	String	—
`token_expires_at`	String (date-time)	Example: `2025-01-01T00:00:00.000Z`
`version`	String	—

APIEntitiesCiRunnerManager

Property	Type	Description
`architecture`	String	Example: `amd64`
`contacted_at`	String	Example: `2023-10-24T01:27:06.549Z`
`created_at`	String	Example: `2023-10-24T01:27:06.549Z`
`id`	Integer (int64)	Example: `8`
`ip_address`	String	Example: `127.0.0.1`
`job_execution_status`	String	Allowed values: `active`, `idle` Example: `idle`
`platform`	String	Example: `linux`
`revision`	String	Example: `91a27b2a`
`status`	String	Example: `online`
`system_id`	String	Example: `runner-1`
`version`	String	Example: `16.11.0`

APIEntitiesCiRunnerRegistrationDetails

Property	Type	Description
`id`	String	—
`token`	String	—
`token_expires_at`	String	—

APIEntitiesCommit

Property	Type	Description
`author_email`	String	Example: `john@example.com`
`author_name`	String	Example: `John Smith`
`authored_date`	String (date-time)	Example: `2012-05-28T04:42:42-07:00`
`committed_date`	String (date-time)	Example: `2012-05-28T04:42:42-07:00`
`committer_email`	String	Example: `jack@example.com`
`committer_name`	String	Example: `Jack Smith`
`created_at`	String (date-time)	Example: `2017-07-26T11:08:53.000+02:00`
`extended_trailers`	Object	Example: `{"Signed-off-by":["John Doe \u003cjohndoe@gitlab.com\u003e","Jane Doe \u003cjanedoe@gitlab.com\u003e"]}`
`id`	String	Example: `2695effb5807a22ff3d138d593fd856244e155e7`
`message`	String	Example: `Initial commit`
`parent_ids`	Array of strings	Example: `["2a4b78934375d7f53875269ffd4f45fd83a84ebe"]`
`short_id`	String	Example: `2695effb`
`title`	String	Example: `Initial commit`
`trailers`	Object	Example: `{"Merged-By":"Jane Doe janedoe@gitlab.com"}`
`web_url`	String	Example: `https://gitlab.example.com/janedoe/gitlab-foss/-/commit/ed899a2f4b50b4370feeea94676502b42383c746`

APIEntitiesCustomAttribute

Property	Type	Description
`key`	String	Example: `foo`
`value`	String	Example: `bar`

APIEntitiesLicenseBasic

Property	Type	Description
`html_url`	String	Example: `http://choosealicense.com/licenses/gpl-3.0`
`key`	String	Example: `gpl-3.0`
`name`	String	Example: `GNU General Public License v3.0`
`nickname`	String	Example: `GNU GPLv3`
`source_url`	String	—

APIEntitiesNamespaceBasic

Property	Type	Description
`avatar_url`	String	Example: `https://example.com/avatar/12345`
`full_path`	String	Example: `group/my_project`
`id`	Integer (int64)	Example: `2`
`kind`	String	Example: `project`
`name`	String	Example: `project`
`parent_id`	Integer (int64)	Example: `1`
`path`	String	Example: `my_project`
`web_url`	String	Example: `https://example.com/group/my_project`

APIEntitiesProjectIdentity

Property	Type	Description
`created_at`	String (date-time)	Example: `2020-05-07T04:27:17.016Z`
`description`	String	Example: `desc`
`id`	Integer (int64)	Example: `1`
`name`	String	Example: `project1`
`name_with_namespace`	String	Example: `John Doe / project1`
`path`	String	Example: `project1`
`path_with_namespace`	String	Example: `namespace1/project1`

APIEntitiesUser

Property	Type	Description
`avatar_path`	String	Example: `/user/avatar/28/The-Big-Lebowski-400-400.png`
`avatar_url`	String	Example: `https://gravatar.com/avatar/1`
`bio`	String	—
`bot`	Boolean	—
`created_at`	String	—
`custom_attributes`	Array of APIEntitiesCustomAttribute	—
`discord`	String	—
`followers`	String	—
`following`	String	—
`github`	String	—
`id`	Integer (int64)	Example: `1`
`is_followed`	String	—
`job_title`	String	—
`linkedin`	String	—
`local_time`	String	—
`location`	String	—
`locked`	Boolean	—
`name`	String	Example: `Administrator`
`organization`	String	—
`pronouns`	String	—
`public_email`	String	Example: `john@example.com`
`state`	String	Example: `active`
`twitter`	String	—
`username`	String	Example: `admin`
`web_url`	String	Example: `https://gitlab.example.com/root`
`website_url`	String	—
`work_information`	String	—

APIEntitiesUserBasic

Property	Type	Description
`avatar_path`	String	Example: `/user/avatar/28/The-Big-Lebowski-400-400.png`
`avatar_url`	String	Example: `https://gravatar.com/avatar/1`
`custom_attributes`	Array of APIEntitiesCustomAttribute	—
`id`	Integer (int64)	Example: `1`
`locked`	Boolean	—
`name`	String	Example: `Administrator`
`public_email`	String	Example: `john@example.com`
`state`	String	Example: `active`
`username`	String	Example: `admin`
`web_url`	String	Example: `https://gitlab.example.com/root`

List all runners in a group

Reset runner registration token

List all runners for a project

Assign a runner to a project

Reset runner registration token

Unassign a runner from a project

List all available runners

List all runners

Reset the runner registration token for the instance

Retrieve details on a runner

Update a runner

Delete a runner

List all jobs processed by a runner

List all managers for a runner

Get projects associated with a runner

Reset an authentication token for a runner

Create a runner owned by currently authenticated user

Schemas

APIEntitiesBasicGroupDetails

APIEntitiesBasicProjectDetails

APIEntitiesCiJobBasicWithProject

APIEntitiesCiPipelineBasic

APIEntitiesCiResetTokenResult

APIEntitiesCiRunner

APIEntitiesCiRunnerDetails

APIEntitiesCiRunnerManager

APIEntitiesCiRunnerRegistrationDetails

APIEntitiesCommit

APIEntitiesCustomAttribute

APIEntitiesLicenseBasic

APIEntitiesNamespaceBasic

APIEntitiesProjectIdentity

APIEntitiesUser

APIEntitiesUserBasic

Request trial access

Thank you

Error

Request callback

Thank you

Something went wrong

Book your sessions

Thank you

Error

Request demo

Thank you

Error

Get the PCI SSC compliance report

Thank you

Error

Request partner program details

Request received

Error