Skip to content

CI/CD Tools

Pipeline management, job control, logs, and CI/CD variable configuration.

Tools Overview

ToolTypePurpose
browse_pipelinesQueryList pipelines, jobs, view logs
manage_pipelineCommandTrigger, retry, cancel pipelines
manage_pipeline_jobCommandPlay, retry, cancel individual jobs
browse_variablesQueryList and get CI/CD variables
manage_variableCommandCreate, update, delete variables

browse_pipelines

View pipeline status, job details, and console output.

Actions

ActionDescription
listList pipelines with filtering
getGet single pipeline details
jobsList jobs in a pipeline
triggersList bridge/trigger jobs in a pipeline
jobGet single job details
logsGet job console output/logs

Examples

json
{
  "action": "list",
  "project_id": "my-org/api",
  "status": "failed",
  "per_page": 10
}
json
{
  "action": "jobs",
  "project_id": "my-org/api",
  "pipeline_id": "1234",
  "job_scope": ["failed"],
  "per_page": 50
}
json
{
  "action": "logs",
  "project_id": "my-org/api",
  "job_id": "5678",
  "start": -100,
  "limit": 100
}

Pipeline Filters

ParameterDescription
statusrunning, pending, success, failed, canceled, manual
refBranch or tag name
sourcepush, web, schedule, merge_request_event, api
usernameFilter by triggering user
order_byid, status, ref, updated_at

Log Navigation

ParameterDescription
startLine number (positive from start, negative from end)
limitMaximum lines to return

manage_pipeline

Trigger and control pipeline execution.

Actions

ActionDescription
createTrigger a new pipeline on branch/tag
retryRe-run a failed/canceled pipeline
cancelStop a running pipeline

Examples

json
{
  "action": "create",
  "project_id": "my-org/api",
  "ref": "main",
  "variables": [
    { "key": "DEPLOY_ENV", "value": "staging" }
  ]
}
json
{
  "action": "retry",
  "project_id": "my-org/api",
  "pipeline_id": "1234"
}
json
{
  "action": "cancel",
  "project_id": "my-org/api",
  "pipeline_id": "1234"
}

manage_pipeline_job

Control individual jobs within a pipeline.

Actions

ActionDescription
playTrigger a manual job
retryRe-run a failed/canceled job
cancelStop a running job

Examples

json
{
  "action": "play",
  "project_id": "my-org/api",
  "job_id": "5678",
  "job_variables_attributes": [
    { "key": "TARGET", "value": "production" }
  ]
}
json
{
  "action": "retry",
  "project_id": "my-org/api",
  "job_id": "5678"
}
json
{
  "action": "cancel",
  "project_id": "my-org/api",
  "job_id": "5678"
}

browse_variables / manage_variable

Manage CI/CD environment variables with scoping and protection.

Examples

json
{
  "action": "list",
  "namespace": "my-org/api",
  "per_page": 50
}
json
{
  "action": "create",
  "namespace": "my-org/api",
  "key": "DEPLOY_TOKEN",
  "value": "secure-value",
  "protected": true,
  "masked": true,
  "environment_scope": "production"
}
json
{
  "action": "update",
  "namespace": "my-org/api",
  "key": "DEPLOY_TOKEN",
  "value": "new-value",
  "protected": true,
  "masked": true
}
json
{
  "action": "delete",
  "namespace": "my-org/api",
  "key": "OLD_VARIABLE"
}

Variable Properties

PropertyDescription
protectedOnly available to protected branches/tags
maskedHidden in job logs (requires 8+ chars, specific charset)
environment_scope* for all, or specific like production
variable_typeenv_var (default) or file

Released under the Apache 2.0 License.