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

# GitLab

> Connect GitLab to your Atako agents — 20 read and 23 write actions.

Let your agents work with your GitLab projects — issues, merge requests, files, pipelines and releases.

## Connection

* **Authentication**: API key (Personal access token (glpat-...)).

<Note>
  GitLab → click your avatar → Edit profile → Access tokens → Add new token. Name it, set an expiration date, tick the "api" scope (or "read\_api" for read-only access), click "Create personal access token" and copy the token (starts with glpat-).

  See [GitLab's documentation](https://gitlab.com/-/user_settings/personal_access_tokens).
</Note>

## Read actions (20)

| Action                | Description                                                   |
| --------------------- | ------------------------------------------------------------- |
| `get_branch`          | Fetch a single repository branch.                             |
| `get_commit`          | Fetch a single commit by SHA or ref name.                     |
| `get_file`            | Fetch a file from the repository (content is base64-encoded). |
| `get_group`           | Fetch a single group by its numeric ID.                       |
| `get_issue`           | Fetch a single project issue by its internal ID (iid).        |
| `get_job`             | Fetch a single CI job by its ID.                              |
| `get_job_log`         | Fetch the log (trace) of a CI job.                            |
| `get_merge_request`   | Fetch a single merge request by its internal ID (iid).        |
| `get_pipeline`        | Fetch a single CI pipeline by its ID.                         |
| `get_project`         | Fetch a single project by its numeric ID.                     |
| `get_release`         | Fetch a single release by its tag name.                       |
| `list_branches`       | List repository branches of a project.                        |
| `list_commits`        | List repository commits, optionally filtered by ref or path.  |
| `list_groups`         | List groups visible to the authenticated user.                |
| `list_issues`         | List issues of a project, optionally filtered.                |
| `list_merge_requests` | List merge requests of a project, optionally filtered.        |
| `list_pipeline_jobs`  | List the jobs of a pipeline.                                  |
| `list_pipelines`      | List CI pipelines of a project, optionally filtered.          |
| `list_projects`       | List projects visible to the authenticated user.              |
| `list_releases`       | List releases of a project, most recent first.                |

## Write actions (23)

| Action                      | Description                                                 |
| --------------------------- | ----------------------------------------------------------- |
| `cancel_pipeline`           | Cancel all jobs of a running pipeline.                      |
| `create_branch`             | Create a new branch from an existing ref.                   |
| `create_commit`             | Create a commit with multiple file actions in one call.     |
| `create_file`               | Create a new file in the repository.                        |
| `create_group`              | Create a new group (or subgroup when parent\_id is set).    |
| `create_issue`              | Open a new issue in a project.                              |
| `create_issue_note`         | Add a comment (note) to an issue.                           |
| `create_merge_request`      | Open a new merge request.                                   |
| `create_merge_request_note` | Add a comment (note) to a merge request.                    |
| `create_pipeline`           | Trigger a new CI pipeline on a ref.                         |
| `create_project`            | Create a new project.                                       |
| `create_release`            | Create a release from an existing or new tag.               |
| `delete_branch`             | Delete a repository branch.                                 |
| `delete_file`               | Delete a file from the repository.                          |
| `delete_issue`              | Delete an issue (requires project owner permission).        |
| `delete_merge_request`      | Delete a merge request (requires project owner permission). |
| `delete_pipeline`           | Delete a pipeline and its jobs, logs and artifacts.         |
| `delete_release`            | Delete a release (the git tag itself is kept).              |
| `merge_merge_request`       | Merge an open merge request.                                |
| `retry_pipeline`            | Retry the failed jobs of a pipeline.                        |
| `update_file`               | Update an existing file in the repository.                  |
| `update_issue`              | Update an issue (edit fields, close or reopen it).          |
| `update_merge_request`      | Update a merge request (edit fields, close or reopen it).   |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.