Pipelines

Los pipelines de un proyecto: listarlos, leer uno o el último, lanzar uno, esperar a que termine, reintentar, cancelar y borrar uno, actualizar sus metadatos y leer sus variables y su informe de pruebas JUnit o su resumen. Borrar un pipeline borra con él sus jobs.

Las programaciones de pipelines (con sus variables, ejecutar una ahora y quedarse con una), los tokens de disparo de pipelines (y lanzar un pipeline con uno) y los grupos de recursos, los bloqueos que impiden que unos jobs se ejecuten a la vez, también son acciones de este grupo.

Preguntas de ejemplo

• “Muestra los pipelines del proyecto 42”
• “¿Cuál es el estado del último pipeline en main?”
• “Reintenta el pipeline fallido”
• “¿Qué pruebas fallaron en el pipeline 1234?”

Cómo llamarlo

• Dinámica, la superficie predeterminada: llama a gitlab_execute_action con action igual al ID de la acción, como pipeline.cancel, y sus parámetros en params. gitlab_find_action encuentra un ID a partir de una descripción de la tarea.
• Meta (GITLAB_MCP_TOOL_SURFACE=meta): llama a gitlab_pipeline con action igual al nombre de la acción, como cancel, y sus parámetros en params.
• Individual (GITLAB_MCP_TOOL_SURFACE=individual): llama a la herramienta propia de la acción, como gitlab_pipeline_cancel, pasándole directamente sus parámetros.

Disponibilidad

Todos los niveles sirven el grupo completo, tanto en instancias autogestionadas como en GitLab.com.

Acciones de solo lectura: 15 de 33, las que conserva un despliegue en modo de solo lectura.

Acciones

La descripción de cada acción, y la de cada uno de sus parámetros, es el texto que sirve el servidor para ella en la superficie predeterminada, citado tal cual; por eso está en inglés. Una acción destructiva solo se ejecuta una vez confirmada, salvo que GITLAB_MCP_YOLO_MODE (o AUTOPILOT) se salte ese paso: la superficie dinámica necesita confirm: true en gitlab_execute_action, y las otras dos aceptan un parámetro confirm o la pregunta del cliente (Acciones destructivas).

Acción	Individual
pipeline.cancel	gitlab_pipeline_cancel
pipeline.create	gitlab_pipeline_create
pipeline.delete	gitlab_pipeline_delete
pipeline.get	gitlab_pipeline_get
pipeline.latest	gitlab_pipeline_latest
pipeline.list	gitlab_pipeline_list
pipeline.resource_group_edit	gitlab_edit_resource_group
pipeline.resource_group_get	gitlab_get_resource_group
pipeline.resource_group_list	gitlab_list_resource_groups
pipeline.resource_group_upcoming_jobs	gitlab_list_resource_group_upcoming_jobs
pipeline.retry	gitlab_pipeline_retry
pipeline.schedule_create	gitlab_pipeline_schedule_create
pipeline.schedule_create_variable	gitlab_pipeline_schedule_create_variable
pipeline.schedule_delete	gitlab_pipeline_schedule_delete
pipeline.schedule_delete_variable	gitlab_pipeline_schedule_delete_variable
pipeline.schedule_edit_variable	gitlab_pipeline_schedule_edit_variable
pipeline.schedule_get	gitlab_pipeline_schedule_get
pipeline.schedule_list	gitlab_pipeline_schedule_list
pipeline.schedule_list_triggered_pipelines	gitlab_pipeline_schedule_list_triggered_pipelines
pipeline.schedule_run	gitlab_pipeline_schedule_run
pipeline.schedule_take_ownership	gitlab_pipeline_schedule_take_ownership
pipeline.schedule_update	gitlab_pipeline_schedule_update
pipeline.test_report	gitlab_pipeline_test_report
pipeline.test_report_summary	gitlab_pipeline_test_report_summary
pipeline.trigger_create	gitlab_pipeline_trigger_create
pipeline.trigger_delete	gitlab_pipeline_trigger_delete
pipeline.trigger_get	gitlab_pipeline_trigger_get
pipeline.trigger_list	gitlab_pipeline_trigger_list
pipeline.trigger_run	gitlab_pipeline_trigger_run
pipeline.trigger_update	gitlab_pipeline_trigger_update
pipeline.update_metadata	gitlab_pipeline_update_metadata
pipeline.variables	gitlab_pipeline_variables
pipeline.wait	gitlab_pipeline_wait

pipeline.cancel

Cancel a running pipeline. Returns: updated pipeline metadata reflecting the canceled status. See also: pipeline.get, pipeline.retry, job.list_project.

• Meta-herramienta: gitlab_pipeline, acción cancel
• Herramienta individual: gitlab_pipeline_cancel
• Nivel: Free
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
pipeline_id	integer	sí	Pipeline ID to act on
project_id	string/integer	sí	Project ID or URL-encoded path

pipeline.create

Create a new pipeline. Returns: created pipeline metadata including ID, status, and target ref. See also: pipeline.get, pipeline.wait, job.list_project.

• Meta-herramienta: gitlab_pipeline, acción create
• Herramienta individual: gitlab_pipeline_create
• Nivel: Free
• Comportamiento: escribe, no idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or URL-encoded path
ref	string	sí	Branch or tag name to run the pipeline for
inputs	object	no	Pipeline input parameters keyed by input name. Values may be string, number, boolean, or array of strings, matching the inputs declared in .gitlab-ci.yml spec:inputs.
variables	object[]	no	Pipeline variables to set

pipeline.delete

Delete a pipeline and all its jobs. Returns: a success status and confirmation message. See also: pipeline.get, pipeline.list, pipeline.cancel.

• Meta-herramienta: gitlab_pipeline, acción delete
• Herramienta individual: gitlab_pipeline_delete
• Nivel: Free
• Comportamiento: escribe, destructiva (necesita confirmación), idempotente

Parámetro	Tipo	Requerido	Descripción
pipeline_id	integer	sí	Pipeline ID to delete
project_id	string/integer	sí	Project ID or URL-encoded path

pipeline.get

Get one pipeline by ID. Returns: full pipeline metadata, status lifecycle fields, and links. See also: pipeline.list, pipeline.variables, job.list_project, pipeline.retry.

• Meta-herramienta: gitlab_pipeline, acción get
• Herramienta individual: gitlab_pipeline_get
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
pipeline_id	integer	sí	Pipeline ID to retrieve
project_id	string/integer	sí	Project ID or URL-encoded path

pipeline.latest

Get the latest pipeline for a ref. Returns: full pipeline metadata for the most recent run. See also: pipeline.get, pipeline.list, job.list_project.

• Meta-herramienta: gitlab_pipeline, acción latest
• Herramienta individual: gitlab_pipeline_latest
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or URL-encoded path
created_after	string	no	Return pipelines created after date (ISO 8601 format). Applies to the list fallback.
created_before	string	no	Return pipelines created before date (ISO 8601 format). Applies to the list fallback.
name	string	no	Filter by pipeline name. Applies to the list fallback.
order_by	string (id, status, ref, updated_at, user_id)	no	Order by field (id, status, ref, updated_at, user_id). Applies to the list fallback.
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Keyset pagination cursor: record id at which to fetch the next page, taken from the previous keyset response. Only used when pagination=‘keyset’.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
ref	string	no	Branch or tag name to filter by (defaults to the default branch)
scope	string (running, pending, finished, branches, tags)	no	Filter by scope (running, pending, finished, branches, tags). Applies to the list fallback.
sha	string	no	Filter by commit SHA. Applies to the list fallback.
sort	string (asc, desc)	no	Sort direction (asc, desc). Applies to the list fallback.
source	string (api, chat, external, external_pull_request_event, merge_request_event, ondemand_dast_scan, ondemand_dast_validation, parent_pipeline, pipeline, push, schedule, security_orchestration_policy, trigger, web, webide)	no	Filter by pipeline source (api, chat, external, external_pull_request_event, merge_request_event, ondemand_dast_scan, ondemand_dast_validation, parent_pipeline, pipeline, push, schedule, security_orchestration_policy, trigger, web, webide). Applies to the list fallback.
status	string (created, waiting_for_resource, preparing, pending, running, success, failed, canceled, skipped, manual, scheduled)	no	Filter by status (created, waiting_for_resource, preparing, pending, running, success, failed, canceled, skipped, manual, scheduled). Applies to the list fallback.
updated_after	string	no	Return pipelines updated after date (ISO 8601 format). Applies to the list fallback.
updated_before	string	no	Return pipelines updated before date (ISO 8601 format). Applies to the list fallback.
username	string	no	Filter by username that triggered the pipeline. Applies to the list fallback.
yaml_errors	boolean	no	Return only pipelines with YAML errors. Applies to the list fallback.

pipeline.list

List project pipelines with filters and pagination. Returns: pipeline IDs, refs, statuses, source, and timing metadata. See also: pipeline.get, pipeline.latest, job.list_project.

• Meta-herramienta: gitlab_pipeline, acción list
• Herramienta individual: gitlab_pipeline_list
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or URL-encoded path
created_after	string	no	Return pipelines created after date (ISO 8601 format, e.g. 2025-01-01T00:00:00Z)
created_before	string	no	Return pipelines created before date (ISO 8601 format, e.g. 2025-12-31T23:59:59Z)
name	string	no	Filter by pipeline name
order_by	string (id, status, ref, updated_at, user_id)	no	Order by field (id, status, ref, updated_at, user_id)
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Keyset pagination cursor: record id at which to fetch the next page, taken from the previous keyset response. Only used when pagination=‘keyset’.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
ref	string	no	Filter by branch or tag name
scope	string (running, pending, finished, branches, tags)	no	Filter by scope (running, pending, finished, branches, tags)
sha	string	no	Filter by commit SHA
sort	string (asc, desc)	no	Sort direction (asc, desc)
source	string (api, chat, external, external_pull_request_event, merge_request_event, ondemand_dast_scan, ondemand_dast_validation, parent_pipeline, pipeline, push, schedule, security_orchestration_policy, trigger, web, webide)	no	Filter by pipeline source (api, chat, external, external_pull_request_event, merge_request_event, ondemand_dast_scan, ondemand_dast_validation, parent_pipeline, pipeline, push, schedule, security_orchestration_policy, trigger, web, webide)
status	string (created, waiting_for_resource, preparing, pending, running, success, failed, canceled, skipped, manual, scheduled)	no	Filter by status (created, waiting_for_resource, preparing, pending, running, success, failed, canceled, skipped, manual, scheduled)
updated_after	string	no	Return pipelines updated after date (ISO 8601 format, e.g. 2025-01-01T00:00:00Z)
updated_before	string	no	Return pipelines updated before date (ISO 8601 format, e.g. 2025-12-31T23:59:59Z)
username	string	no	Filter by username that triggered the pipeline
yaml_errors	boolean	no	Return only pipelines with YAML errors

pipeline.resource_group_edit

Update the process mode of one CI resource group by key. Returns: the updated resource group ID, key, new process mode that controls how queued jobs sharing the resource group are serialized, and created and updated times. See also: pipeline.resource_group_get, pipeline.resource_group_list, pipeline.resource_group_upcoming_jobs.

• Meta-herramienta: gitlab_pipeline, acción resource_group_edit
• Herramienta individual: gitlab_edit_resource_group
• Nivel: Free
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
key	string	sí	Resource group key
process_mode	string (unordered, oldest_first, newest_first, newest_ready_first)	sí	Process mode: unordered, oldest_first, newest_first, or newest_ready_first
project_id	string/integer	sí	Project ID or URL-encoded path

pipeline.resource_group_get

Get one CI resource group in a project by key. Returns: the resource group ID, key, process mode (the concurrency mode that controls how jobs sharing the resource group are serialized), and created and updated times. See also: pipeline.resource_group_list, pipeline.resource_group_edit, pipeline.resource_group_upcoming_jobs.

• Meta-herramienta: gitlab_pipeline, acción resource_group_get
• Herramienta individual: gitlab_get_resource_group
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
key	string	sí	Resource group key
project_id	string/integer	sí	Project ID or URL-encoded path

pipeline.resource_group_list

List the CI resource groups configured for a project. Returns: each resource group’s ID, key, process mode that controls how jobs sharing the group are serialized to limit pipeline concurrency, and created and updated times, with pagination metadata. See also: pipeline.resource_group_get, pipeline.resource_group_edit, pipeline.resource_group_upcoming_jobs.

• Meta-herramienta: gitlab_pipeline, acción resource_group_list
• Herramienta individual: gitlab_list_resource_groups
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or URL-encoded path
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.

pipeline.resource_group_upcoming_jobs

List the upcoming CI jobs queued for one resource group by key. Returns: each pending job’s ID, name, status, stage, ref, tag and allow-failure flags, pipeline, web URL, and creation time, ordered as they will run under the resource group’s process mode, with pagination metadata. See also: pipeline.resource_group_get, pipeline.resource_group_list, job.list.

• Meta-herramienta: gitlab_pipeline, acción resource_group_upcoming_jobs
• Herramienta individual: gitlab_list_resource_group_upcoming_jobs
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
key	string	sí	Resource group key
project_id	string/integer	sí	Project ID or URL-encoded path
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.

pipeline.retry

Retry failed and canceled jobs in a pipeline. Returns: updated pipeline metadata after re-queuing jobs. See also: pipeline.get, pipeline.cancel, job.list_project.

• Meta-herramienta: gitlab_pipeline, acción retry
• Herramienta individual: gitlab_pipeline_retry
• Nivel: Free
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
pipeline_id	integer	sí	Pipeline ID to act on
project_id	string/integer	sí	Project ID or URL-encoded path

pipeline.schedule_create

Create a pipeline schedule. Returns: the created schedule with id, description, ref, cron, owner, and inputs. See also: pipeline.schedule_get, pipeline.schedule_update, pipeline.schedule_list.

• Meta-herramienta: gitlab_pipeline, acción schedule_create
• Herramienta individual: gitlab_pipeline_schedule_create
• Nivel: Free
• Comportamiento: escribe, no idempotente

Parámetro	Tipo	Requerido	Descripción
cron	string	sí	Cron expression (e.g. 0 1 * * *)
description	string	sí	Schedule description
project_id	string/integer	sí	Project ID or URL-encoded path
ref	string	sí	Branch or tag to run the pipeline on
active	boolean	no	Whether the schedule is active (default: true)
cron_timezone	string	no	Cron timezone (e.g. UTC or America/New_York)
inputs	object[]	no	Pipeline inputs to seed on the schedule. Each entry has name and value

pipeline.schedule_create_variable

Create a pipeline schedule variable. Returns: the created variable with key, value, variable_type, and raw. See also: pipeline.schedule_edit_variable, pipeline.schedule_delete_variable.

• Meta-herramienta: gitlab_pipeline, acción schedule_create_variable
• Herramienta individual: gitlab_pipeline_schedule_create_variable
• Nivel: Free
• Comportamiento: escribe, no idempotente

Parámetro	Tipo	Requerido	Descripción
key	string	sí	Variable key
project_id	string/integer	sí	Project ID or URL-encoded path
schedule_id	integer	sí	Pipeline schedule ID
value	string	sí	Variable value. Required when creating a schedule variable
variable_type	string (env_var, file)	no	Variable type: env_var (default) or file

pipeline.schedule_delete

Delete a pipeline schedule permanently. Returns: a success confirmation. See also: pipeline.schedule_get, pipeline.schedule_list.

• Meta-herramienta: gitlab_pipeline, acción schedule_delete
• Herramienta individual: gitlab_pipeline_schedule_delete
• Nivel: Free
• Comportamiento: escribe, destructiva (necesita confirmación), idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or URL-encoded path
schedule_id	integer	sí	Pipeline schedule ID

pipeline.schedule_delete_variable

Delete a pipeline schedule variable. Returns: a success confirmation naming the key. See also: pipeline.schedule_create_variable, pipeline.schedule_edit_variable.

• Meta-herramienta: gitlab_pipeline, acción schedule_delete_variable
• Herramienta individual: gitlab_pipeline_schedule_delete_variable
• Nivel: Free
• Comportamiento: escribe, destructiva (necesita confirmación), idempotente

Parámetro	Tipo	Requerido	Descripción
key	string	sí	Variable key to delete
project_id	string/integer	sí	Project ID or URL-encoded path
schedule_id	integer	sí	Pipeline schedule ID

pipeline.schedule_edit_variable

Edit a pipeline schedule variable. Returns: the updated variable with key, value, variable_type, and raw. See also: pipeline.schedule_create_variable, pipeline.schedule_delete_variable.

• Meta-herramienta: gitlab_pipeline, acción schedule_edit_variable
• Herramienta individual: gitlab_pipeline_schedule_edit_variable
• Nivel: Free
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
key	string	sí	Variable key to edit
project_id	string/integer	sí	Project ID or URL-encoded path
schedule_id	integer	sí	Pipeline schedule ID
value	string	sí	New variable value. Required when editing a schedule variable
variable_type	string (env_var, file)	no	Variable type: env_var or file

pipeline.schedule_get

Get a single pipeline schedule by ID. Returns: the schedule with cron, ref, owner, last_pipeline, variables, and inputs. See also: pipeline.schedule_list, pipeline.schedule_update, pipeline.schedule_run.

• Meta-herramienta: gitlab_pipeline, acción schedule_get
• Herramienta individual: gitlab_pipeline_schedule_get
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or URL-encoded path
schedule_id	integer	sí	Pipeline schedule ID

pipeline.schedule_list

List pipeline schedules in a project. Returns: schedules with description, ref, cron, owner, and pagination metadata. See also: pipeline.schedule_get, pipeline.schedule_create.

• Meta-herramienta: gitlab_pipeline, acción schedule_list
• Herramienta individual: gitlab_pipeline_schedule_list
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or URL-encoded path
order_by	string	no	Column to order keyset-paginated results by (e.g. id)
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Keyset pagination cursor: record id at which to fetch the next page, taken from the previous keyset response. Only used when pagination=‘keyset’.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
scope	string (active, inactive)	no	Filter by scope: active or inactive
sort	string (asc, desc)	no	Sort order for keyset pagination: asc or desc

pipeline.schedule_list_triggered_pipelines

List pipelines triggered by a schedule. Returns: triggered pipelines with status, ref, sha, web URL, and pagination metadata. See also: pipeline.schedule_get, pipeline.schedule_run.

• Meta-herramienta: gitlab_pipeline, acción schedule_list_triggered_pipelines
• Herramienta individual: gitlab_pipeline_schedule_list_triggered_pipelines
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or URL-encoded path
schedule_id	integer	sí	Pipeline schedule ID
order_by	string	no	Column to order results by (e.g. id)
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Keyset pagination cursor: record id at which to fetch the next page, taken from the previous keyset response. Only used when pagination=‘keyset’.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
sort	string (asc, desc)	no	Sort direction for triggered pipelines: asc or desc (default asc)

pipeline.schedule_run

Run a pipeline schedule immediately. Returns: the schedule’s current state after triggering. See also: pipeline.schedule_get, pipeline.schedule_list_triggered_pipelines.

• Meta-herramienta: gitlab_pipeline, acción schedule_run
• Herramienta individual: gitlab_pipeline_schedule_run
• Nivel: Free
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or URL-encoded path
schedule_id	integer	sí	Pipeline schedule ID

pipeline.schedule_take_ownership

Take ownership of a pipeline schedule. Returns: the schedule with the caller as owner. See also: pipeline.schedule_update, pipeline.schedule_run.

• Meta-herramienta: gitlab_pipeline, acción schedule_take_ownership
• Herramienta individual: gitlab_pipeline_schedule_take_ownership
• Nivel: Free
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or URL-encoded path
schedule_id	integer	sí	Pipeline schedule ID

pipeline.schedule_update

Update a pipeline schedule. Returns: the updated schedule with cron, ref, owner, and inputs. See also: pipeline.schedule_get, pipeline.schedule_take_ownership.

• Meta-herramienta: gitlab_pipeline, acción schedule_update
• Herramienta individual: gitlab_pipeline_schedule_update
• Nivel: Free
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or URL-encoded path
schedule_id	integer	sí	Pipeline schedule ID
active	boolean	no	Enable or disable the schedule
cron	string	no	Updated cron expression
cron_timezone	string	no	Updated cron timezone
description	string	no	Updated description
inputs	object[]	no	Pipeline inputs to set on the schedule. Each entry has name, value, and optional destroy
ref	string	no	Updated branch or tag

pipeline.test_report

Get a pipeline’s full test report. Returns: total/passed/failed/skipped counts and per-suite breakdown. See also: pipeline.test_report_summary, pipeline.get, job.list_project.

• Meta-herramienta: gitlab_pipeline, acción test_report
• Herramienta individual: gitlab_pipeline_test_report
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
pipeline_id	integer	sí	Pipeline ID to retrieve
project_id	string/integer	sí	Project ID or URL-encoded path

pipeline.test_report_summary

Get a pipeline’s test report summary. Returns: aggregate test totals and per-suite summaries with build IDs. See also: pipeline.test_report, pipeline.get, job.list_project.

• Meta-herramienta: gitlab_pipeline, acción test_report_summary
• Herramienta individual: gitlab_pipeline_test_report_summary
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
pipeline_id	integer	sí	Pipeline ID to retrieve
project_id	string/integer	sí	Project ID or URL-encoded path

pipeline.trigger_create

Create a pipeline trigger token. Returns: the created trigger with id, description, token secret, and owner. See also: pipeline.trigger_run, pipeline.trigger_list, pipeline.trigger_delete.

• Meta-herramienta: gitlab_pipeline, acción trigger_create
• Herramienta individual: gitlab_pipeline_trigger_create
• Nivel: Free
• Comportamiento: escribe, no idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or path
description	string	no	Trigger token description

pipeline.trigger_delete

Delete a pipeline trigger token. Returns: a success confirmation. See also: pipeline.trigger_get, pipeline.trigger_create.

• Meta-herramienta: gitlab_pipeline, acción trigger_delete
• Herramienta individual: gitlab_pipeline_trigger_delete
• Nivel: Free
• Comportamiento: escribe, destructiva (necesita confirmación), idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or path
trigger_id	integer	sí	Pipeline trigger ID

pipeline.trigger_get

Get a single pipeline trigger token. Returns: the trigger with id, description, token, owner, and timestamps. See also: pipeline.trigger_list, pipeline.trigger_update, pipeline.trigger_delete.

• Meta-herramienta: gitlab_pipeline, acción trigger_get
• Herramienta individual: gitlab_pipeline_trigger_get
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or path
trigger_id	integer	sí	Pipeline trigger ID

pipeline.trigger_list

List a project’s pipeline trigger tokens. Returns: trigger tokens with id, description, owner, last-used time, and pagination metadata. See also: pipeline.trigger_get, pipeline.trigger_create, pipeline.trigger_run.

• Meta-herramienta: gitlab_pipeline, acción trigger_list
• Herramienta individual: gitlab_pipeline_trigger_list
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or path
order_by	string	no	Field by which to order results when using keyset pagination (e.g. id).
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Keyset pagination cursor: record id at which to fetch the next page, taken from the previous keyset response. Only used when pagination=‘keyset’.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
sort	string (asc, desc)	no	Sort order: asc or desc. Defaults to the API ordering.

pipeline.trigger_run

Trigger a pipeline using a trigger token. Returns: the created pipeline with id, status, ref, sha, source, user, detailed_status, and web URL. See also: pipeline.trigger_list, pipeline.get.

• Meta-herramienta: gitlab_pipeline, acción trigger_run
• Herramienta individual: gitlab_pipeline_trigger_run
• Nivel: Free
• Comportamiento: escribe, no idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or path
inputs	object	no	Map of pipeline input name to value (string, number, boolean, or array of strings) for inputs declared in the pipeline spec.
ref	string	no	Branch or tag name to run pipeline on
token	string	no	Pipeline trigger token
variables	object	no	Map of CI/CD variable name to value injected into the triggered pipeline.

pipeline.trigger_update

Update a pipeline trigger token’s description. Returns: the updated trigger with id, description, token, and owner. See also: pipeline.trigger_get, pipeline.trigger_delete.

• Meta-herramienta: gitlab_pipeline, acción trigger_update
• Herramienta individual: gitlab_pipeline_trigger_update
• Nivel: Free
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or path
trigger_id	integer	sí	Pipeline trigger ID
description	string	no	New trigger token description

pipeline.update_metadata

Update a pipeline’s name. Returns: updated pipeline metadata reflecting the new name. See also: pipeline.get, pipeline.list, pipeline.create.

• Meta-herramienta: gitlab_pipeline, acción update_metadata
• Herramienta individual: gitlab_pipeline_update_metadata
• Nivel: Free
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
name	string	sí	New pipeline name
pipeline_id	integer	sí	Pipeline ID to update
project_id	string/integer	sí	Project ID or URL-encoded path

pipeline.variables

List a pipeline’s runtime variables. Returns: variable keys, values, types, and whether each value is raw (not expanded). See also: pipeline.get, pipeline.create, job.list_project.

• Meta-herramienta: gitlab_pipeline, acción variables
• Herramienta individual: gitlab_pipeline_variables
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
pipeline_id	integer	sí	Pipeline ID to retrieve
project_id	string/integer	sí	Project ID or URL-encoded path

pipeline.wait

Use only to poll an existing pipeline_id until a terminal status. For merge when pipeline succeeds, use merge_request.merge with auto_merge=true instead.

• Meta-herramienta: gitlab_pipeline, acción wait
• Herramienta individual: gitlab_pipeline_wait
• Nivel: Free
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
pipeline_id	integer	sí	Pipeline ID returned by pipeline.list, pipeline.get, pipeline.latest, or merge_request.pipelines. Do not use merge_request_iid.
project_id	string/integer	sí	Project ID or URL-encoded path
fail_on_error	boolean	no	Return isError when pipeline ends in failed/canceled status (default true)
interval_seconds	integer	no	Polling interval in seconds (5-60, default 10)
timeout_seconds	integer	no	Maximum wait time in seconds (1-3600, default 300)