GitLab CI/CD

Connect your GitLab instance by saving your Personal Access Token plus its base URL, after checking they actually work together. You'll need a Personal Access Token with the 'api' scope (or 'read_api' for read-only use) -- create it in User Settings > Access Tokens (works for both gitlab.com and your own self-managed instance). Scoped to CI/CD only -- repository files, merge requests and issues are out of scope here.

Disconnect a GitLab instance: deletes the saved Personal Access Token. Nothing in GitLab itself is changed; the token remains valid there until you revoke it yourself.

List the connected GitLab instances.

List pipelines in a project, optionally filtered by ref, status, scope, source, or the username who triggered them.

Read one pipeline in full -- status, timing, and its own CI/CD variables entrypoint.

Read the CI/CD variables a specific pipeline run was actually triggered with.

Read a pipeline's aggregated JUnit test report, if the pipeline published one (total/success/failed/skipped/error counts per suite).

Trigger a new pipeline run for a project on a given ref (branch/tag), optionally passing CI/CD variables.

Retry a failed or canceled pipeline's failed jobs.

Cancel a running pipeline.

Permanently delete a pipeline and its jobs/artifacts/logs. Cannot be undone.

List jobs across a project's pipelines, optionally filtered by status scope.

List the jobs belonging to one pipeline, optionally filtered by status scope.

List the bridge (trigger) jobs of a pipeline -- jobs that trigger downstream/multi-project pipelines, with the downstream pipeline and project they triggered.

Read one job in full -- status, timing, runner, and stage.

Read a job's console log/trace, capped to the last N lines (traces can be very large).

Retry a failed or canceled job.

Cancel a running job.

Run a manual job that's waiting for a trigger.

Erase a job's trace and artifacts (irreversible cleanup, job record itself stays).

List runners visible to you (or, with all_runners, every runner on the instance if you're an admin), optionally filtered by scope (active/paused/online/offline), type, or tags.

Read one runner in full -- version, IP, tags, timeout, and contact status.

Update a runner's description, pause state, tags, untagged-job acceptance, lock, access level, or max timeout. Only given fields change.

Permanently delete/unregister a runner. Cannot be undone.

List jobs that ran on one specific runner, optionally filtered by status.

List runners enabled/assigned to a specific project.

Enable (assign) an existing runner for a project so its pipelines can use it.

Disable (unassign) a runner from a project. Does not delete the runner itself.

List CI/CD variables defined at project level.

Read one project CI/CD variable's value and settings.

Create a new project-level CI/CD variable -- key/value plus protection, masking, scope, and type settings.

Update an existing project CI/CD variable's value/protection/masking/scope/description.

Permanently delete a project CI/CD variable.

List CI/CD variables defined at group level (inherited by every project in the group).

Read one group CI/CD variable's value and settings.

Create a new group-level CI/CD variable, inherited by every project in the group.

Update an existing group CI/CD variable's value/protection/masking/scope/description.

Permanently delete a group CI/CD variable.

List pipeline trigger tokens defined on a project.

Create a new pipeline trigger token for a project -- use its token value with run_pipeline_trigger to trigger pipelines from external CI/CD systems without a full Personal Access Token.

Update an existing pipeline trigger token's description.

Permanently revoke/delete a pipeline trigger token.

Trigger a pipeline run using a trigger token (not a Personal Access Token) -- GitLab's documented mechanism for external CI/CD systems.

List pipeline schedules (cron-triggered pipelines) defined on a project.

Read one pipeline schedule in full, including its next run time and owner.

Create a new pipeline schedule -- a cron-triggered pipeline on a given ref.

Update an existing pipeline schedule's description, ref, cron, timezone, or active state.

Permanently delete a pipeline schedule.

Trigger a pipeline schedule to run right now (rate-limited by GitLab to once per minute).

Create or update a CI/CD variable attached to a pipeline schedule (upserts: creates if new, updates if the key already exists).

Permanently remove a CI/CD variable from a pipeline schedule.

Validate raw .gitlab-ci.yml content against GitLab's CI Lint engine -- checks syntax and semantic errors before you commit a pipeline config.

Validate a project's own .gitlab-ci.yml (its current config on a ref, or explicit content), with the project's own includes/extends resolved.

Get the signed download URL for a job's artifacts archive. GitLab streams the binary archive directly rather than a JSON body, so this returns the URL to fetch rather than the archive itself.

Mark a job's artifacts as kept -- exempts them from the project's expiry policy so they are never automatically deleted.

Permanently delete a job's artifacts archive right now, ahead of its expiry policy. Cannot be undone.

List environments (deployment targets like staging/production) defined on a project.

Read one environment in full -- its state, external URL, and deployment tier.

Create a new environment (deployment target) on a project.

Update an existing environment's name or external URL.

Permanently delete an environment. Cannot be undone.

Stop an environment -- ends its active deployment (e.g. tears down a review app).

List deployments in a project, optionally filtered by environment or status.

Read one deployment in full -- its environment, status, ref, and who triggered it.

Approve or reject a deployment awaiting manual approval (protected environments with approval rules configured).

Retry several pipelines in one call, by explicit pipeline ids. Continues past per-item failures and reports which succeeded.

Cancel several running pipelines in one call, by explicit pipeline ids. Continues past per-item failures and reports which succeeded.

Retry several jobs in one call, by explicit job ids. Continues past per-item failures and reports which succeeded.

Cancel several running jobs in one call, by explicit job ids. Continues past per-item failures and reports which succeeded.

Value-add report: scan the most recent pipelines' failed jobs so recurring flaky/broken jobs stand out, instead of scrolling through every pipeline individually.

Value-add report: one-glance CI/CD health snapshot for a project -- pipeline success rate, failing pipelines, runner availability, and CI/CD variable documentation, as named check rows.