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 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. job.artifactsJob 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.cancelJob 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_artifactsJob 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_artifactsJob 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_artifactsJob 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_artifactJob 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_refJob 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.eraseJob 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.getJob 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_artifactsJob 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.listJob 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_bridgesJob 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_projectJob 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.playJob 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.retryJob 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_groupAdd 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_projectAdd 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_getGet 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_groupsList 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_inboundList 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_patchPatch 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_groupRemove 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_projectRemove 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.traceJob 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.waitJob 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)