Action domain

runner

Every action this domain exposes through gitlab_execute_action, from the gitlab://tools manifest. Each entry folds out to its full upstream description and required parameters.

19 · actions4 · destructive8 · read-only

Counted with a Free-tier GitLab token. The catalog is scoped to the token that asks, so the count moves with both its tier and its permissions: higher tiers expose more actions, and administration domains only appear to tokens allowed to use them.

Back to the server card

1. runner.delete_by_tokenRunner Delete By Tokendestructive

   Delete a registered runner by its authentication token. Returns: a success confirmation. See also: runner.delete_registered, runner.remove.

   Required parameters: token (string)

2. runner.delete_registeredRunner Delete Registereddestructive

   Delete a registered runner by its numeric runner_id. Returns: a success confirmation. See also: runner.delete_by_token, runner.remove.

   Required parameters: runner_id (integer)

3. runner.disable_projectRunner Disable Projectdestructive

   Remove a runner assignment from a project by project_id and runner_id. Returns: a success confirmation. See also: runner.enable_project, runner.list_project.

   Required parameters: project_id (string), runner_id (integer)

4. runner.enable_projectRunner Enable Project

   Assign an existing runner to a project by project_id and runner_id. Returns: the enabled runner. See also: runner.disable_project, runner.list_project.

   Required parameters: project_id (string), runner_id (integer)

5. runner.getRunner Getread-only

   Get full configuration for one runner by numeric runner_id. Returns: runner details including tags, locked, access level, maximum timeout, contact time, and associated groups/projects. See also: runner.list, runner.update, runner.jobs.

   Required parameters: runner_id (integer)

6. runner.jobsRunner Jobsread-only

   List jobs processed by a runner, with status/order/sort filters and pagination. Returns: jobs with id, name, status, stage, ref, and duration, plus pagination metadata. See also: runner.get, job.get.

   Required parameters: runner_id (integer)

7. runner.listRunner Listread-only

   List runners owned by the authenticated user, with type/status/tag/scope filters and pagination. Returns: runners with id, name, type, status, paused/shared/online flags, plus pagination metadata. See also: runner.get, runner.list_all, runner.list_project.

   Required parameters: No required parameters

8. runner.list_allRunner List Allread-only

   List every runner on the instance (admin token required), with type/status/tag/scope filters and pagination. Returns: runners with id, name, type, status, flags, plus pagination metadata. See also: runner.list, runner.get.

   Required parameters: No required parameters

9. runner.list_groupRunner List Groupread-only

   List runners available in a group (specific and shared), with type/status/tag filters and pagination. Returns: runners with id, name, type, status, flags, plus pagination metadata. See also: runner.list, runner.list_project.

   Required parameters: group_id (string)

10. runner.list_managersRunner List Managersread-only

    List the managers of a runner by runner_id. Returns: runner managers with system id, version, revision, platform, architecture, status, and IP. See also: runner.get, runner.list.

    Required parameters: runner_id (integer)

11. runner.list_projectRunner List Projectread-only

    List runners assigned to a project, with type/status/tag/scope filters and pagination. Returns: runners with id, name, type, status, flags, plus pagination metadata. See also: runner.enable_project, runner.disable_project, runner.list.

    Required parameters: project_id (string)

12. runner.registerRunner Register

    Register a new runner with a registration token, optional info hashmap, tags, and configuration. Returns: the created runner including its authentication token. See also: runner.verify, runner.list.

    Required parameters: token (string)

13. runner.removeRunner Removedestructive

    Remove (unregister) a runner by numeric runner_id. Returns: a success confirmation. See also: runner.disable_project, runner.delete_registered, runner.get.

    Required parameters: runner_id (integer)

14. runner.reset_group_reg_tokenRunner Reset Group Reg Token

    Reset a group's runner registration token by group_id (deprecated). Returns: the new registration token and its expiry. See also: runner.reset_instance_reg_token, runner.reset_project_reg_token.

    Required parameters: group_id (string)

15. runner.reset_instance_reg_tokenRunner Reset Instance Reg Token

    Reset the instance-level runner registration token (deprecated, admin only). Returns: the new registration token and its expiry. See also: runner.reset_group_reg_token, runner.reset_project_reg_token.

    Required parameters: No required parameters

16. runner.reset_project_reg_tokenRunner Reset Project Reg Token

    Reset a project's runner registration token by project_id (deprecated). Returns: the new registration token and its expiry. See also: runner.reset_instance_reg_token, runner.reset_group_reg_token.

    Required parameters: project_id (string)

17. runner.reset_tokenRunner Reset Token

    Reset a runner's authentication token by runner_id. Returns: the new token and its expiry. See also: runner.verify, runner.get.

    Required parameters: runner_id (integer)

18. runner.updateRunner Update

    Update a runner's configuration (description, pause state, tags, locked, access level, timeout) by runner_id. Returns: the updated runner details. See also: runner.get, runner.remove.

    Required parameters: runner_id (integer)

19. runner.verifyRunner Verifyread-only

    Verify that a runner authentication token is valid. Returns: a success confirmation when the token authenticates. See also: runner.register, runner.reset_token.

    Required parameters: token (string)