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 token against gitlab.com, which is the only host this endpoint talks to: to use it against a self-managed instance, run the server yourself — its documentation covers that. 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. That is why the figures differ elsewhere: the upstream project catalogues 1,006 actions across 162 domains, and 851 on the Free/CE surface, while this deployment publishes 747 because it is OAuth-only and acts with your token, so the administration domains a non-admin account cannot call never appear. All three describe the same catalog, counted from three vantage points.

Back to the server card

1. runner.delete_by_token

   Runner 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_registered

   Runner 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_project

   Runner 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_project

   Runner 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.get

   Runner 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.jobs

   Runner 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.list

   Runner 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_all

   Runner 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_group

   Runner 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_managers

    Runner 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_project

    Runner 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.register

    Runner 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.remove

    Runner 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_token

    Runner 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_token

    Runner 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_token

    Runner 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_token

    Runner 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.update

    Runner 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.verify

    Runner 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)