list_pipelines
Retrieve and filter CI/CD pipelines for a GitLab project by status, branch, commit, or other criteria to monitor build status and execution history.
Instructions
List pipelines in a project
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Filter by pipeline name | |
| order_by | No | Order pipelines by field | id |
| per_page | No | Number of results per page (max 100) | |
| project_id | Yes | Project ID or path | |
| ref | No | Filter by branch or tag name | |
| sha | No | Filter by commit SHA | |
| sort | No | Sort order | desc |
| status | No | Filter by pipeline status | |
| updated_after | No | Filter pipelines updated after this date (ISO 8601 format) | |
| updated_before | No | Filter pipelines updated before this date (ISO 8601 format) | |
| username | No | Filter by username of the user who triggered the pipeline | |
| yaml_errors | No | Filter pipelines with YAML errors |
Input Schema (JSON Schema)
{
"properties": {
"name": {
"description": "Filter by pipeline name",
"type": "string"
},
"order_by": {
"default": "id",
"description": "Order pipelines by field",
"enum": [
"id",
"status",
"ref",
"updated_at",
"user_id"
],
"type": "string"
},
"per_page": {
"default": 20,
"description": "Number of results per page (max 100)",
"maximum": 100,
"type": "number"
},
"project_id": {
"description": "Project ID or path",
"type": "string"
},
"ref": {
"description": "Filter by branch or tag name",
"type": "string"
},
"sha": {
"description": "Filter by commit SHA",
"type": "string"
},
"sort": {
"default": "desc",
"description": "Sort order",
"enum": [
"asc",
"desc"
],
"type": "string"
},
"status": {
"description": "Filter by pipeline status",
"enum": [
"created",
"waiting_for_resource",
"preparing",
"pending",
"running",
"success",
"failed",
"canceled",
"skipped",
"manual",
"scheduled"
],
"type": "string"
},
"updated_after": {
"description": "Filter pipelines updated after this date (ISO 8601 format)",
"type": "string"
},
"updated_before": {
"description": "Filter pipelines updated before this date (ISO 8601 format)",
"type": "string"
},
"username": {
"description": "Filter by username of the user who triggered the pipeline",
"type": "string"
},
"yaml_errors": {
"description": "Filter pipelines with YAML errors",
"type": "boolean"
}
},
"required": [
"project_id"
],
"type": "object"
}