> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# gitlab-cicd

> GitLab CI/CD - manage pipelines, jobs, and releases

**Server path:** `/gitlab-cicd` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                  | Description                              |
| --------------------------------------------------------------------- | ---------------------------------------- |
| [`gitlab_cicd_cancel_pipeline`](#gitlab_cicd_cancel_pipeline)         | Cancel all jobs for a pipeline           |
| [`gitlab_cicd_create_pipeline`](#gitlab_cicd_create_pipeline)         | Create a new pipeline                    |
| [`gitlab_cicd_get_job`](#gitlab_cicd_get_job)                         | Retrieve a job                           |
| [`gitlab_cicd_get_job_log`](#gitlab_cicd_get_job_log)                 | Retrieve a log file for a job            |
| [`gitlab_cicd_get_pipeline`](#gitlab_cicd_get_pipeline)               | Gets a specific pipeline for the project |
| [`gitlab_cicd_get_pipeline_jobs`](#gitlab_cicd_get_pipeline_jobs)     | Get pipeline jobs                        |
| [`gitlab_cicd_get_release`](#gitlab_cicd_get_release)                 | Retrieve a release by tag name           |
| [`gitlab_cicd_list_group_projects`](#gitlab_cicd_list_group_projects) | Get a list of projects in this group.    |
| [`gitlab_cicd_list_pipelines`](#gitlab_cicd_list_pipelines)           | Get all Pipelines of the project         |
| [`gitlab_cicd_list_releases`](#gitlab_cicd_list_releases)             | List all releases in a project           |
| [`gitlab_cicd_retry_job`](#gitlab_cicd_retry_job)                     | Retry a job                              |
| [`gitlab_cicd_retry_pipeline`](#gitlab_cicd_retry_pipeline)           | Retry builds in the pipeline             |

***

## gitlab\_cicd\_cancel\_pipeline

Cancel all jobs for a pipeline

**Parameters:**

| Parameter     | Type    | Required | Default | Description                        |
| ------------- | ------- | -------- | ------- | ---------------------------------- |
| `id`          | string  | Yes      | —       | The project ID or URL-encoded path |
| `pipeline_id` | integer | Yes      | —       | The pipeline ID                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "The project ID or URL-encoded path"
      },
      "pipeline_id": {
        "type": "integer",
        "description": "The pipeline ID"
      }
    },
    "required": [
      "PCID",
      "id",
      "pipeline_id"
    ]
  }
  ```
</Expandable>

***

## gitlab\_cicd\_create\_pipeline

Create a new pipeline

**Parameters:**

| Parameter   | Type      | Required | Default | Description                                           |
| ----------- | --------- | -------- | ------- | ----------------------------------------------------- |
| `id`        | string    | Yes      | —       | The project ID or URL-encoded path                    |
| `inputs`    | object    | No       | —       | The list of inputs to be used to create the pipeline. |
| `ref`       | string    | Yes      | —       | Reference                                             |
| `variables` | object\[] | No       | —       | Array of variables available in the pipeline          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "The project ID or URL-encoded path"
      },
      "inputs": {
        "type": "object",
        "description": "The list of inputs to be used to create the pipeline."
      },
      "ref": {
        "type": "string",
        "description": "Reference"
      },
      "variables": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "key": {
              "type": "string",
              "description": "The key of the variable"
            },
            "value": {
              "type": "string",
              "description": "The value of the variable"
            },
            "variable_type": {
              "type": "string",
              "enum": [
                "env_var",
                "file"
              ],
              "description": "The type of variable, must be one of env_var or file. Defaults to env_var"
            }
          }
        },
        "description": "Array of variables available in the pipeline"
      }
    },
    "required": [
      "PCID",
      "id",
      "ref"
    ]
  }
  ```
</Expandable>

***

## gitlab\_cicd\_get\_job

Retrieve a job

**Parameters:**

| Parameter | Type    | Required | Default | Description     |
| --------- | ------- | -------- | ------- | --------------- |
| `job_id`  | integer | Yes      | —       | The ID of a job |
| `id`      | integer | Yes      | —       | The id value    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "job_id": {
        "type": "integer",
        "description": "The ID of a job"
      },
      "id": {
        "type": "integer",
        "description": "The id value"
      }
    },
    "required": [
      "PCID",
      "job_id",
      "id"
    ]
  }
  ```
</Expandable>

***

## gitlab\_cicd\_get\_job\_log

Retrieve a log file for a job

**Parameters:**

| Parameter     | Type    | Required | Default | Description                       |
| ------------- | ------- | -------- | ------- | --------------------------------- |
| `job_id`      | integer | Yes      | —       | The ID of a job                   |
| `byte_offset` | integer | No       | —       | Byte offset to start reading from |
| `byte_limit`  | integer | No       | —       | Maximum number of bytes to return |
| `id`          | integer | Yes      | —       | The id value                      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "job_id": {
        "type": "integer",
        "description": "The ID of a job"
      },
      "byte_offset": {
        "type": "integer",
        "description": "Byte offset to start reading from"
      },
      "byte_limit": {
        "type": "integer",
        "description": "Maximum number of bytes to return"
      },
      "id": {
        "type": "integer",
        "description": "The id value"
      }
    },
    "required": [
      "PCID",
      "job_id",
      "id"
    ]
  }
  ```
</Expandable>

***

## gitlab\_cicd\_get\_pipeline

Gets a specific pipeline for the project

**Parameters:**

| Parameter     | Type    | Required | Default | Description                        |
| ------------- | ------- | -------- | ------- | ---------------------------------- |
| `id`          | string  | Yes      | —       | The project ID or URL-encoded path |
| `pipeline_id` | integer | Yes      | —       | The pipeline ID                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "The project ID or URL-encoded path"
      },
      "pipeline_id": {
        "type": "integer",
        "description": "The pipeline ID"
      }
    },
    "required": [
      "PCID",
      "id",
      "pipeline_id"
    ]
  }
  ```
</Expandable>

***

## gitlab\_cicd\_get\_pipeline\_jobs

Get pipeline jobs

**Parameters:**

| Parameter         | Type    | Required | Default | Description                        |
| ----------------- | ------- | -------- | ------- | ---------------------------------- |
| `id`              | string  | Yes      | —       | The project ID or URL-encoded path |
| `pipeline_id`     | integer | Yes      | —       | The pipeline ID                    |
| `include_retried` | boolean | No       | —       | Includes retried jobs              |
| `scope`           | string  | No       | —       | The scope of builds to show        |
| `page`            | integer | No       | —       | Current page number                |
| `per_page`        | integer | No       | —       | Number of items per page           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "The project ID or URL-encoded path"
      },
      "pipeline_id": {
        "type": "integer",
        "description": "The pipeline ID"
      },
      "include_retried": {
        "type": "boolean",
        "description": "Includes retried jobs"
      },
      "scope": {
        "type": "string",
        "description": "The scope of builds to show",
        "enum": [
          "created",
          "waiting_for_resource",
          "preparing",
          "waiting_for_callback",
          "pending",
          "running",
          "success",
          "failed",
          "canceling",
          "canceled",
          "skipped",
          "manual",
          "scheduled"
        ]
      },
      "page": {
        "type": "integer",
        "description": "Current page number"
      },
      "per_page": {
        "type": "integer",
        "description": "Number of items per page"
      }
    },
    "required": [
      "PCID",
      "id",
      "pipeline_id"
    ]
  }
  ```
</Expandable>

***

## gitlab\_cicd\_get\_release

Retrieve a release by tag name

**Parameters:**

| Parameter                  | Type    | Required | Default | Description                                                                      |
| -------------------------- | ------- | -------- | ------- | -------------------------------------------------------------------------------- |
| `id`                       | string  | Yes      | —       | The ID or URL-encoded path of the project                                        |
| `tag_name`                 | string  | Yes      | —       | The Git tag the release is associated with                                       |
| `include_html_description` | boolean | No       | —       | If `true`, a response includes HTML rendered markdown of the release description |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "The ID or URL-encoded path of the project"
      },
      "tag_name": {
        "type": "string",
        "description": "The Git tag the release is associated with"
      },
      "include_html_description": {
        "type": "boolean",
        "description": "If `true`, a response includes HTML rendered markdown of the release description"
      }
    },
    "required": [
      "PCID",
      "id",
      "tag_name"
    ]
  }
  ```
</Expandable>

***

## gitlab\_cicd\_list\_group\_projects

Get a list of projects in this group.

**Parameters:**

| Parameter                     | Type    | Required | Default | Description                                                         |
| ----------------------------- | ------- | -------- | ------- | ------------------------------------------------------------------- |
| `id`                          | string  | Yes      | —       | The ID of a group                                                   |
| `active`                      | boolean | No       | —       | Limit by projects that are not archived and not marked for deletion |
| `archived`                    | boolean | No       | —       | Limit by archived status                                            |
| `visibility`                  | string  | No       | —       | Limit by visibility                                                 |
| `search`                      | string  | No       | —       | Return list of authorized projects matching the search criteria     |
| `order_by`                    | string  | No       | —       | Return projects ordered by field                                    |
| `sort`                        | string  | No       | —       | Return projects sorted in ascending and descending order            |
| `simple`                      | boolean | No       | —       | Return only the ID, URL, name, and path of each project             |
| `owned`                       | boolean | No       | —       | Limit by owned by authenticated user                                |
| `starred`                     | boolean | No       | —       | Limit by starred status                                             |
| `with_issues_enabled`         | boolean | No       | —       | Limit by enabled issues feature                                     |
| `with_merge_requests_enabled` | boolean | No       | —       | Limit by enabled merge requests feature                             |
| `with_shared`                 | boolean | No       | —       | Include projects shared to this group                               |
| `include_subgroups`           | boolean | No       | —       | Includes projects in subgroups of this group                        |
| `include_ancestor_groups`     | boolean | No       | —       | Includes projects in ancestors of this group                        |
| `min_access_level`            | integer | No       | —       | Limit by minimum access level of authenticated user on projects     |
| `page`                        | integer | No       | —       | Current page number                                                 |
| `per_page`                    | integer | No       | —       | Number of items per page                                            |
| `with_custom_attributes`      | boolean | No       | —       | Include custom attributes in the response                           |
| `with_security_reports`       | boolean | No       | —       | Return only projects having security report artifacts present       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "The ID of a group"
      },
      "active": {
        "type": "boolean",
        "description": "Limit by projects that are not archived and not marked for deletion"
      },
      "archived": {
        "type": "boolean",
        "description": "Limit by archived status"
      },
      "visibility": {
        "type": "string",
        "description": "Limit by visibility",
        "enum": [
          "private",
          "internal",
          "public"
        ]
      },
      "search": {
        "type": "string",
        "description": "Return list of authorized projects matching the search criteria"
      },
      "order_by": {
        "type": "string",
        "description": "Return projects ordered by field",
        "enum": [
          "id",
          "name",
          "path",
          "created_at",
          "updated_at",
          "last_activity_at",
          "similarity",
          "star_count"
        ]
      },
      "sort": {
        "type": "string",
        "description": "Return projects sorted in ascending and descending order",
        "enum": [
          "asc",
          "desc"
        ]
      },
      "simple": {
        "type": "boolean",
        "description": "Return only the ID, URL, name, and path of each project"
      },
      "owned": {
        "type": "boolean",
        "description": "Limit by owned by authenticated user"
      },
      "starred": {
        "type": "boolean",
        "description": "Limit by starred status"
      },
      "with_issues_enabled": {
        "type": "boolean",
        "description": "Limit by enabled issues feature"
      },
      "with_merge_requests_enabled": {
        "type": "boolean",
        "description": "Limit by enabled merge requests feature"
      },
      "with_shared": {
        "type": "boolean",
        "description": "Include projects shared to this group"
      },
      "include_subgroups": {
        "type": "boolean",
        "description": "Includes projects in subgroups of this group"
      },
      "include_ancestor_groups": {
        "type": "boolean",
        "description": "Includes projects in ancestors of this group"
      },
      "min_access_level": {
        "type": "integer",
        "description": "Limit by minimum access level of authenticated user on projects",
        "enum": [
          10,
          15,
          20,
          30,
          40,
          50
        ]
      },
      "page": {
        "type": "integer",
        "description": "Current page number"
      },
      "per_page": {
        "type": "integer",
        "description": "Number of items per page"
      },
      "with_custom_attributes": {
        "type": "boolean",
        "description": "Include custom attributes in the response"
      },
      "with_security_reports": {
        "type": "boolean",
        "description": "Return only projects having security report artifacts present"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## gitlab\_cicd\_list\_pipelines

Get all Pipelines of the project

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                                                   |
| ---------------- | ------- | -------- | ------- | --------------------------------------------------------------------------------------------- |
| `id`             | string  | Yes      | —       | The project ID or URL-encoded path                                                            |
| `page`           | integer | No       | —       | Current page number                                                                           |
| `per_page`       | integer | No       | —       | Number of items per page                                                                      |
| `scope`          | string  | No       | —       | The scope of pipelines                                                                        |
| `status`         | string  | No       | —       | The status of pipelines                                                                       |
| `ref`            | string  | No       | —       | The ref of pipelines                                                                          |
| `sha`            | string  | No       | —       | The sha of pipelines                                                                          |
| `yaml_errors`    | boolean | No       | —       | Returns pipelines with invalid configurations                                                 |
| `username`       | string  | No       | —       | The username of the user who triggered pipelines                                              |
| `updated_before` | string  | No       | —       | Return pipelines updated before the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ |
| `updated_after`  | string  | No       | —       | Return pipelines updated after the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ  |
| `created_before` | string  | No       | —       | Return pipelines created before the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ |
| `created_after`  | string  | No       | —       | Return pipelines created after the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ  |
| `order_by`       | string  | No       | —       | Order pipelines                                                                               |
| `sort`           | string  | No       | —       | Sort pipelines                                                                                |
| `source`         | string  | No       | —       | The source of pipelines                                                                       |
| `name`           | string  | No       | —       | Filter pipelines by name                                                                      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "The project ID or URL-encoded path"
      },
      "page": {
        "type": "integer",
        "description": "Current page number"
      },
      "per_page": {
        "type": "integer",
        "description": "Number of items per page"
      },
      "scope": {
        "type": "string",
        "description": "The scope of pipelines",
        "enum": [
          "running",
          "pending",
          "finished",
          "branches",
          "tags"
        ]
      },
      "status": {
        "type": "string",
        "description": "The status of pipelines",
        "enum": [
          "created",
          "waiting_for_resource",
          "preparing",
          "waiting_for_callback",
          "pending",
          "running",
          "success",
          "failed",
          "canceling",
          "canceled",
          "skipped",
          "manual",
          "scheduled"
        ]
      },
      "ref": {
        "type": "string",
        "description": "The ref of pipelines"
      },
      "sha": {
        "type": "string",
        "description": "The sha of pipelines"
      },
      "yaml_errors": {
        "type": "boolean",
        "description": "Returns pipelines with invalid configurations"
      },
      "username": {
        "type": "string",
        "description": "The username of the user who triggered pipelines"
      },
      "updated_before": {
        "type": "string",
        "description": "Return pipelines updated before the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ"
      },
      "updated_after": {
        "type": "string",
        "description": "Return pipelines updated after the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ"
      },
      "created_before": {
        "type": "string",
        "description": "Return pipelines created before the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ"
      },
      "created_after": {
        "type": "string",
        "description": "Return pipelines created after the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ"
      },
      "order_by": {
        "type": "string",
        "description": "Order pipelines",
        "enum": [
          "id",
          "status",
          "ref",
          "updated_at",
          "user_id"
        ]
      },
      "sort": {
        "type": "string",
        "description": "Sort pipelines",
        "enum": [
          "asc",
          "desc"
        ]
      },
      "source": {
        "type": "string",
        "description": "The source of pipelines",
        "enum": [
          "unknown",
          "push",
          "web",
          "trigger",
          "schedule",
          "api",
          "external",
          "pipeline",
          "chat",
          "webide",
          "merge_request_event",
          "external_pull_request_event",
          "parent_pipeline",
          "ondemand_dast_scan",
          "ondemand_dast_validation",
          "security_orchestration_policy",
          "container_registry_push",
          "duo_workflow",
          "pipeline_execution_policy_schedule",
          "dependency_management_security_update"
        ]
      },
      "name": {
        "type": "string",
        "description": "Filter pipelines by name"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## gitlab\_cicd\_list\_releases

List all releases in a project

**Parameters:**

| Parameter                  | Type    | Required | Default | Description                                                                                           |
| -------------------------- | ------- | -------- | ------- | ----------------------------------------------------------------------------------------------------- |
| `id`                       | string  | Yes      | —       | The ID or URL-encoded path of the project                                                             |
| `page`                     | integer | No       | —       | Current page number                                                                                   |
| `per_page`                 | integer | No       | —       | Number of items per page                                                                              |
| `order_by`                 | string  | No       | —       | The field to use as order. Either `released_at` (default) or `created_at`                             |
| `sort`                     | string  | No       | —       | The direction of the order. Either `desc` (default) for descending order or `asc` for ascending order |
| `include_html_description` | boolean | No       | —       | If `true`, a response includes HTML rendered markdown of the release description                      |
| `updated_before`           | string  | No       | —       | Return releases updated before the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ          |
| `updated_after`            | string  | No       | —       | Return releases updated after the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "The ID or URL-encoded path of the project"
      },
      "page": {
        "type": "integer",
        "description": "Current page number"
      },
      "per_page": {
        "type": "integer",
        "description": "Number of items per page"
      },
      "order_by": {
        "type": "string",
        "description": "The field to use as order. Either `released_at` (default) or `created_at`",
        "enum": [
          "released_at",
          "created_at"
        ]
      },
      "sort": {
        "type": "string",
        "description": "The direction of the order. Either `desc` (default) for descending order or `asc` for ascending order",
        "enum": [
          "asc",
          "desc"
        ]
      },
      "include_html_description": {
        "type": "boolean",
        "description": "If `true`, a response includes HTML rendered markdown of the release description"
      },
      "updated_before": {
        "type": "string",
        "description": "Return releases updated before the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ"
      },
      "updated_after": {
        "type": "string",
        "description": "Return releases updated after the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## gitlab\_cicd\_retry\_job

Retry a job

**Parameters:**

| Parameter | Type    | Required | Default | Description              |
| --------- | ------- | -------- | ------- | ------------------------ |
| `job_id`  | integer | Yes      | —       | The ID of a job          |
| `id`      | integer | Yes      | —       | The id value             |
| `inputs`  | object  | No       | —       | Input values for the job |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "job_id": {
        "type": "integer",
        "description": "The ID of a job"
      },
      "id": {
        "type": "integer",
        "description": "The id value"
      },
      "inputs": {
        "type": "object",
        "description": "Input values for the job"
      }
    },
    "required": [
      "PCID",
      "job_id",
      "id"
    ]
  }
  ```
</Expandable>

***

## gitlab\_cicd\_retry\_pipeline

Retry builds in the pipeline

**Parameters:**

| Parameter     | Type    | Required | Default | Description                        |
| ------------- | ------- | -------- | ------- | ---------------------------------- |
| `id`          | string  | Yes      | —       | The project ID or URL-encoded path |
| `pipeline_id` | integer | Yes      | —       | The pipeline ID                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "The project ID or URL-encoded path"
      },
      "pipeline_id": {
        "type": "integer",
        "description": "The pipeline ID"
      }
    },
    "required": [
      "PCID",
      "id",
      "pipeline_id"
    ]
  }
  ```
</Expandable>