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

# GitLab

> Review GitLab merge requests directly within Pwnbook.

<img src="https://mintcdn.com/pwnbook/noJyYhCscAD7TYUE/logos/gitlab.svg?fit=max&auto=format&n=noJyYhCscAD7TYUE&q=85&s=d6f6909e481a23e9b03f0fb8a4e4c029" alt="GitLab" style={{ height: "32px", marginBottom: "16px" }} width="100" height="92" data-path="logos/gitlab.svg" />

## Overview

The GitLab integration brings merge request review into Pwnbook. View open, merged, and closed MRs, read diffs, and track review status without leaving the platform.

## Prerequisites

* A GitLab account (GitLab.com or self-managed)
* A GitLab personal access token or group access token with `read_api` scope
* Admin or Owner access in Pwnbook

## Setup

<Steps>
  <Step title="Create a GitLab access token">
    **Personal access token:**

    1. In GitLab, go to **User Settings → Access Tokens**.
    2. Create a token with the `read_api` scope.
    3. Copy the token.

    **Group access token (recommended for teams):**

    1. Go to your group → **Settings → Access Tokens**.
    2. Create a token with `read_api` and the Reporter role.
  </Step>

  <Step title="Configure in Pwnbook">
    1. Go to **Organization Settings → Marketplace → GitLab**.
    2. Enter your **Access Token** and optionally your **GitLab host** (for self-managed instances).
    3. Select the **groups or projects** to monitor.
    4. Click **Save & Test**.
  </Step>
</Steps>

## What's available

| View               | Description                                                                  |
| ------------------ | ---------------------------------------------------------------------------- |
| **Merge requests** | Open, merged, and closed MRs with author, target branch, and pipeline status |
| **Diffs**          | File-level diffs for each MR                                                 |
| **Review status**  | Approval state and reviewer assignments                                      |