Action domain

job

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.

25 · actions5 · destructive13 · 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. job.artifacts

   Job Artifactsread-only

   Download the full artifact archive for a CI job (base64-encoded, truncated at 1MB). Returns: archive size, content, and truncation flag. See also: job.download_single_artifact, job.keep_artifacts, job.get.

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

2. job.cancel

   Job Cancel

   Cancel a CI job. Set force:true to cancel jobs already in a non-cancellable state (requires GitLab v17.2+). Returns: updated job state. See also: job.get, job.retry.

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

3. job.delete_artifacts

   Job Delete Artifactsdestructive

   Delete the artifacts for one CI job (destructive). Returns: a success confirmation. See also: job.artifacts, job.get, job.delete_project_artifacts.

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

4. job.delete_project_artifacts

   Job Delete Project Artifactsdestructive

   Delete every eligible artifact across a project (destructive, irreversible). Returns: a success confirmation. See also: job.delete_artifacts, job.list_project, job.artifacts.

   Required parameters: project_id (string)

5. job.download_artifacts

   Job Download Artifactsread-only

   Download the latest successful artifacts archive for a ref and job name. Returns: archive size, content, and truncation flag. See also: job.artifacts, job.download_single_artifact, job.get.

   Required parameters: project_id (string)

6. job.download_single_artifact

   Job Download Single Artifactread-only

   Download one artifact file from a job by job_id and artifact_path. Returns: file size, raw content, and truncation flag. See also: job.artifacts, job.download_artifacts, job.get.

   Required parameters: artifact_path (string), job_id (integer), project_id (string)

7. job.download_single_artifact_by_ref

   Job Download Single Artifact By Refread-only

   Download one artifact file from the latest successful job on a ref by name and path. Returns: file size, raw content, and truncation flag. See also: job.download_artifacts, job.download_single_artifact, job.get.

   Required parameters: artifact_path (string), job (string), project_id (string), ref_name (string)

8. job.erase

   Job Erasedestructive

   Erase a finished CI job's trace log and artifacts (destructive). Returns: updated job state. See also: job.get, job.trace, job.artifacts.

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

9. job.get

   Job Getread-only

   Get one CI job. Returns: status, stage, ref, embedded commit/pipeline/project/runner/user objects, timing fields, and failure metadata. See also: job.trace, job.cancel, job.retry.

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

10. job.keep_artifacts

    Job Keep Artifacts

    Keep a CI job's artifacts by clearing their expiration. Returns: updated job state. See also: job.artifacts, job.get, job.download_artifacts.

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

11. job.list

    Job Listread-only

    List CI jobs for one pipeline with status filters, keyset pagination, and ordering. Returns: job summaries with status, stage, ref, and pipeline association. See also: job.get, job.trace, pipeline.get.

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

12. job.list_bridges

    Job List Bridgesread-only

    List CI bridge (trigger) jobs for one pipeline with keyset pagination. Returns: bridge summaries with status and downstream pipeline references. See also: job.list, pipeline.get, job.get.

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

13. job.list_project

    Job List Projectread-only

    List CI jobs in one project with filters, keyset pagination, and ordering. Returns: job summaries, status, stage, ref, and pipeline associations. See also: job.get, job.trace, pipeline.get.

    Required parameters: project_id (string)

14. job.play

    Job Play

    Run a manual CI job with optional variable overrides. Returns: the started job state. See also: job.get, job.retry, job.trace.

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

15. job.retry

    Job Retry

    Retry a failed or canceled CI job. Returns: the newly created job state. See also: job.get, job.trace, job.cancel.

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

16. job.token_scope_add_group

    Add Group Job Token Allowlist

    Add a group to a project's CI/CD job token allowlist. Returns: the new allowlist entry with source project ID and target group ID. See also: job.token_scope_list_groups, job.token_scope_remove_group, job.token_scope_add_project.

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

17. job.token_scope_add_project

    Add Project Job Token Allowlist

    Add a project to a project's CI/CD job token inbound allowlist. Returns: the new allowlist entry with source and target project IDs. See also: job.token_scope_list_inbound, job.token_scope_remove_project, job.token_scope_add_group.

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

18. job.token_scope_get

    Get Job Token Access Settingsread-only

    Get a project's CI/CD job token access settings. Returns: whether inbound job token access is limited to the allowlist. See also: job.token_scope_patch, job.token_scope_list_inbound, job.token_scope_list_groups.

    Required parameters: project_id (string)

19. job.token_scope_list_groups

    List Job Token Group Allowlistread-only

    List groups on a project's CI/CD job token allowlist. Returns: allowlisted groups with id, name, full path, and web URL plus pagination metadata. See also: job.token_scope_add_group, job.token_scope_remove_group, job.token_scope_get.

    Required parameters: project_id (string)

20. job.token_scope_list_inbound

    List Job Token Inbound Allowlistread-only

    List projects on a project's CI/CD job token inbound allowlist. Returns: allowlisted projects with id, name, path, and web URL plus pagination metadata. See also: job.token_scope_add_project, job.token_scope_remove_project, job.token_scope_get.

    Required parameters: project_id (string)

21. job.token_scope_patch

    Patch Job Token Access Settings

    Update a project's CI/CD job token access settings. Returns: a confirmation that the inbound scope setting was updated. See also: job.token_scope_get, job.token_scope_add_project, job.token_scope_add_group.

    Required parameters: enabled (boolean), project_id (string)

22. job.token_scope_remove_group

    Remove Group Job Token Allowlistdestructive

    Remove a group from a project's CI/CD job token allowlist. Returns: a success confirmation naming the removed group. See also: job.token_scope_list_groups, job.token_scope_add_group, job.token_scope_remove_project.

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

23. job.token_scope_remove_project

    Remove Project Job Token Allowlistdestructive

    Remove a project from a project's CI/CD job token inbound allowlist. Returns: a success confirmation naming the removed project. See also: job.token_scope_list_inbound, job.token_scope_add_project, job.token_scope_remove_group.

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

24. job.trace

    Job Traceread-only

    Get CI job trace output. Returns: text log with truncation metadata when logs exceed limits. See also: job.get, job.retry, job.cancel.

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

25. job.wait

    Job Waitread-only

    Wait for a CI job to finish, polling until terminal state or timeout. Returns: final job snapshot, wait duration, poll count, and timed-out flag. See also: job.get, job.trace, job.retry.

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