# Fiche connecteur GitLab
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## GitLab
URL : https://get-bruno.com/features/connectors/gitlab
Référence texte : https://get-bruno.com/features/connectors/gitlab/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Outils de développement
Description : GitLab est une plateforme DevSecOps pour gérer du code, des issues, des branches et des merge requests. Elle sert aussi à suivre les révisions, les commentaires et l’état de fusion d’un changement.
Authentification : OAuth
Présentation : GitLab est une plateforme DevSecOps pour gérer du code, des issues, des branches et des merge requests. Elle sert aussi à suivre les révisions, les commentaires et l’état de fusion d’un changement.
Usage : Préparer une revue de merge request
Exemple de demande : Je veux vérifier la merge request « Refactor cache Redis » du projet Atlas, lire ses différences et savoir si elle est prête à être relue.
Résultat attendu : Tu obtiens le détail de la merge request, les diffs utiles à la revue et les informations de fusion nécessaires pour décider quoi commenter.
À préciser : Le projet visé ou son groupe ; Le numéro de merge request ou son titre exact ; L’objet du changement à examiner, ici « Refactor cache Redis »
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/gitlab/actions/get-merge-request ; https://pipedream.com/apps/gitlab/actions/get-merge-request-diffs ; https://pipedream.com/apps/gitlab/actions/search-merge-requests
Usage : Retrouver une issue à partir de son titre
Exemple de demande : Je veux retrouver l’issue « Erreur de facturation client » dans le projet Atlas à partir de son titre, puis ouvrir l’issue trouvée pour voir son contenu avant de la mettre à jour.
Résultat attendu : Tu obtiens les résultats de recherche, puis l’issue repérée avec ses informations principales pour préparer une modification ou un suivi.
À préciser : Le projet concerné ; Le titre à rechercher ; Le numéro de l’issue repérée
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/gitlab/actions/search-issues ; https://pipedream.com/apps/gitlab/actions/get-issue
Usage : Créer une branche puis ouvrir une merge request
Exemple de demande : Je veux créer une branche « fix-login-timeout » dans le projet Atlas puis ouvrir une merge request vers la branche principale.
Résultat attendu : Tu obtiens une branche créée puis une merge request ouverte à partir de cette branche, avec un état initial à vérifier ensuite.
À préciser : Le projet concerné ; Le nom de la branche source à créer, ici « fix-login-timeout » ; La branche cible de fusion ; Le résumé du changement à présenter
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/gitlab/actions/create-branch ; https://pipedream.com/apps/gitlab/actions/create-merge-request ; https://pipedream.com/apps/gitlab/actions/list-repo-branches
Limites propres au service : Les commentaires en ligne dépendent des chemins de fichier et des numéros de ligne renvoyés par les diffs. Une branche source et une branche cible doivent déjà exister pour ouvrir une merge request. La recherche de merge requests par texte est sensible au périmètre projet ou groupe fourni. Les labels appliqués doivent être vérifiés avant usage, sinon GitLab peut créer un nouveau label au lieu de reprendre celui attendu.
Vocabulaire français : Approuver une merge request — Approuve une merge request pour l’utilisateur authentifié, ou retire une approbation précédente si l’action est réglée sur unapprove. Il faut vérifier d’abord l’état de la merge request et ses diffs, car GitLab peut refuser une auto-approbation ou une règle d’approbation non satisfaite. (https://pipedream.com/apps/gitlab/actions/approve-merge-request)
Vocabulaire français : Créer une branche — Crée une nouvelle branche dans le dépôt. (https://pipedream.com/apps/gitlab/actions/create-branch)
Vocabulaire français : Créer un epic — Crée un nouvel epic. (https://pipedream.com/apps/gitlab/actions/create-epic)
Vocabulaire français : Créer une issue — Crée une nouvelle issue dans un dépôt. (https://pipedream.com/apps/gitlab/actions/create-issue)
Vocabulaire français : Créer une merge request — Ouvre une merge request entre deux branches existantes et peut marquer le brouillon si la revue n’est pas prête. (https://pipedream.com/apps/gitlab/actions/create-merge-request)
Vocabulaire français : Créer un commentaire de merge request — Ajoute un commentaire global, une réponse à un fil existant, ou un commentaire inline sur une ligne de diff. (https://pipedream.com/apps/gitlab/actions/create-merge-request-comment)
Vocabulaire français : Créer une revue de merge request — Publie une revue complète avec plusieurs commentaires inline, un commentaire de synthèse et, si demandé, une approbation. (https://pipedream.com/apps/gitlab/actions/create-merge-request-review)
Vocabulaire français : Obtenir une issue — Récupère une issue unique d’un dépôt. (https://pipedream.com/apps/gitlab/actions/get-issue)
Vocabulaire français : Obtenir une merge request — Récupère une merge request avec un résumé de son état, de ses conflits, de sa pipeline et de ses approbations. (https://pipedream.com/apps/gitlab/actions/get-merge-request)
Vocabulaire français : Obtenir les commits d’une merge request — Liste les commits contenus dans une merge request, du plus récent au plus ancien. (https://pipedream.com/apps/gitlab/actions/get-merge-request-commits)
Vocabulaire français : Obtenir les diffs d’une merge request — Liste les fichiers modifiés et les différences d’une merge request pour préparer une revue ou un commentaire inline. (https://pipedream.com/apps/gitlab/actions/get-merge-request-diffs)
Vocabulaire français : Obtenir une branche du dépôt — Récupère une branche précise d’un projet. (https://pipedream.com/apps/gitlab/actions/get-repo-branch)
Vocabulaire français : Lister les commits — Liste les commits d’une branche de dépôt. (https://pipedream.com/apps/gitlab/actions/list-commits)
Vocabulaire français : Lister les options d’identifiant de groupe — Récupère les valeurs possibles pour le champ Group ID. (https://pipedream.com/apps/gitlab/actions/list-group-id-options)
Vocabulaire français : Lister les options de chemin de groupe — Récupère les valeurs possibles pour le champ Group Path. (https://pipedream.com/apps/gitlab/actions/list-group-path-options)
Vocabulaire français : Lister les groupes — Liste tous les groupes accessibles. (https://pipedream.com/apps/gitlab/actions/list-groups)
Vocabulaire français : Lister les discussions d’une merge request — Liste les fils de commentaires d’une merge request, y compris les discussions inline et leurs états de résolution. (https://pipedream.com/apps/gitlab/actions/list-merge-request-discussions)
Vocabulaire français : Lister les merge requests — Liste les merge requests selon le projet, le groupe, l’état, l’auteur, l’assigné, le relecteur, les labels ou la branche cible. (https://pipedream.com/apps/gitlab/actions/list-merge-requests)
Vocabulaire français : Lister les options d’identifiant de projet — Récupère les valeurs possibles pour le champ Project ID. (https://pipedream.com/apps/gitlab/actions/list-project-id-options)
Vocabulaire français : Lister les labels d’un projet — Liste les labels définis dans un projet pour éviter d’en créer un nouveau par erreur. (https://pipedream.com/apps/gitlab/actions/list-project-labels)
Vocabulaire français : Lister les membres d’un projet — Liste tous les membres d’un projet. (https://pipedream.com/apps/gitlab/actions/list-project-members)
Vocabulaire français : Lister les projets — Liste ou recherche des projets GitLab avec des filtres de recherche, de propriété ou d’appartenance. (https://pipedream.com/apps/gitlab/actions/list-projects)
Vocabulaire français : Lister les branches du dépôt — Récupère la liste des branches d’un projet. (https://pipedream.com/apps/gitlab/actions/list-repo-branches)
Vocabulaire français : Résoudre un fil de merge request — Marque un fil de discussion comme résolu, ou le rouvre si nécessaire. (https://pipedream.com/apps/gitlab/actions/resolve-merge-request-thread)
Vocabulaire français : Rechercher des issues — Recherche des issues dans un dépôt à partir d’une requête texte. (https://pipedream.com/apps/gitlab/actions/search-issues)
Vocabulaire français : Rechercher des merge requests — Recherche des merge requests par titre ou description et aide à retrouver leur iid. (https://pipedream.com/apps/gitlab/actions/search-merge-requests)
Vocabulaire français : Mettre à jour un epic — Met à jour un epic existant. (https://pipedream.com/apps/gitlab/actions/update-epic)
Vocabulaire français : Mettre à jour une issue — Met à jour une issue existante. (https://pipedream.com/apps/gitlab/actions/update-issue)
Vocabulaire français : Nouveau commit instantané — Déclenche un événement lorsqu’un nouveau commit est poussé sur une branche. (https://pipedream.com/apps/gitlab/triggers/new-commit)
Vocabulaire français : Nouvelle branche instantanée — Déclenche un événement lorsqu’une nouvelle branche est créée. (https://pipedream.com/apps/gitlab/triggers/new-branch)
Vocabulaire français : Nouveau projet — Déclenche un événement lorsqu’un nouveau projet est créé. (https://pipedream.com/apps/gitlab/triggers/new-project)
Vocabulaire français : Nouvel événement d’audit instantané — Déclenche un événement lorsqu’un nouvel événement d’audit est créé. (https://pipedream.com/apps/gitlab/triggers/new-audit-event)
Vocabulaire français : Nouveau commentaire de commit instantané — Déclenche un événement lorsqu’un commit reçoit un commentaire. (https://pipedream.com/apps/gitlab/triggers/new-commit-comment)
Vocabulaire français : Nouvelle issue instantanée — Déclenche un événement lorsqu’une issue est créée dans un projet. (https://pipedream.com/apps/gitlab/triggers/new-issue)
Vocabulaire français : Nouvelle mention instantanée — Déclenche un événement lorsque l’utilisateur est mentionné dans un commit, un commentaire, une issue ou une merge request. (https://pipedream.com/apps/gitlab/triggers/new-mention)
Vocabulaire français : Nouvelle merge request instantanée — Déclenche un événement lorsqu’une merge request est créée. (https://pipedream.com/apps/gitlab/triggers/new-merge-request)
Vocabulaire français : Nouveau jalon — Déclenche un événement lorsqu’un jalon est créé dans un projet. (https://pipedream.com/apps/gitlab/triggers/new-milestone)
Vocabulaire français : Nouvelle demande de relecture instantanée — Déclenche un événement lorsqu’un relecteur est ajouté à une merge request. (https://pipedream.com/apps/gitlab/triggers/new-review-request)
- action : Approve Merge Request — Approve a merge request as the authenticated user, or withdraw an earlier approval by setting Action to unapprove . Call Get Merge Request first to check the merge request is actually ready — its readiness rollup reports the pipeline status, conflicts and how many approvals are still required — and Get Merge Request Diffs to read the changes being approved. Two things commonly go wrong: GitLab refuses to let you approve your own merge request , and a project may require approval from a specific approval rule that the authenticated user does not satisfy; both surface as a 401 . To approve as part of leaving review feedback in one step, use Create Merge Request Review with its Action set to approve instead. Optionally pass SHA to make the approval conditional on the merge request's head commit, so it fails rather than silently approving work that was pushed after you read the diff. See the documentation (https://pipedream.com/apps/gitlab/actions/approve-merge-request)
- action : Create Branch — Create a new branch in the repository. See the documentation (https://pipedream.com/apps/gitlab/actions/create-branch)
- action : Create Epic — Creates a new epic. See the documentation (https://pipedream.com/apps/gitlab/actions/create-epic)
- action : Create issue — Creates a new issue. See the documentation (https://pipedream.com/apps/gitlab/actions/create-issue)
- action : Create Merge Request — Open a new merge request from one branch into another. Use this for "open an MR", "raise a merge request", "submit my branch for review". Both branches must already exist in the project — use List Repo Branches to check, or Create Branch to make one. Reviewers and assignees are given as usernames and resolved to IDs automatically; a username that is not a member of the project is rejected rather than silently dropped. Set Draft to true for work that is not ready for review — GitLab expresses this by prefixing the title with Draft: , which this action does for you and which blocks merging until removed. After creating, use Get Merge Request to check its pipeline and merge readiness. See the documentation (https://pipedream.com/apps/gitlab/actions/create-merge-request)
- action : Create Merge Request Comment — Post a comment on a merge request. It works in three modes, chosen by which props you set: leave File Path and Discussion ID blank for a plain comment on the merge request as a whole; set File Path plus a line number to open an inline thread anchored to that line of the diff; or set Discussion ID to reply inside an existing thread. Use Get Merge Request Diffs first to get valid file paths and line numbers, and List Merge Request Discussions to get a Discussion ID to reply to. Line numbers follow GitLab's diff rules: for a line the merge request adds or leaves unchanged, pass New Line ; for a line it removes , pass Old Line ; for an unchanged context line, pass both. Getting that wrong is the usual cause of a rejected inline comment. To post several review comments at once, and optionally approve in the same step, use Create Merge Request Review instead. See the documentation (https://pipedream.com/apps/gitlab/actions/create-merge-request-comment)
- action : Create Merge Request Review — Submit a whole review on a merge request in one step: any number of inline comments anchored to lines of the diff, an overall summary comment, and optionally an approval. This is the tool for "review this MR" — call Get Merge Request and Get Merge Request Diffs first to read the changes, then send the findings back here. GitLab has no single submit-review API, so this action posts each inline comment as its own thread and then approves if asked; if an individual comment is rejected (usually a line that is not part of the diff) the rest are still posted and the failures are returned in failed , so check that array rather than assuming everything landed. Line numbers follow GitLab's diff rules: new_line for a line the merge request adds, old_line for a line it removes, both for an unchanged context line. There is no REST equivalent of GitLab's Request changes state — to block a merge request, leave the findings as comments and do not approve. See the documentation (https://pipedream.com/apps/gitlab/actions/create-merge-request-review)
- action : Get Issue — Gets a single issue from repository. See the documentation (https://pipedream.com/apps/gitlab/actions/get-issue)
- action : Get Merge Request — Get a single merge request together with a readiness rollup that answers "can this be merged?" in one call — state, draft flag, detailed_merge_status , conflict flag, whether blocking threads are resolved, head pipeline status, and the approval count with who has approved. Use this to open or inspect a merge request, and before approving or merging one. It does not return the code changes: call Get Merge Request Diffs for those, and List Merge Request Discussions for existing review comments. If you only know the merge request by title, resolve its iid with Search Merge Requests first. The response also carries diff_refs , the commit SHAs needed to anchor inline comments — no other tool needs to fetch them. See the documentation (https://pipedream.com/apps/gitlab/actions/get-merge-request)
- action : Get Merge Request Commits — List the commits contained in a merge request, newest first. Use this to understand how a change was built up — whether it is one clean commit or a long history to squash, who wrote each part, and what the commit messages claim. For the actual code changes call Get Merge Request Diffs instead; for merge readiness call Get Merge Request . See the documentation (https://pipedream.com/apps/gitlab/actions/get-merge-request-commits)
- action : Get Merge Request Diffs — List the file-level changes in a merge request — each changed file's path, whether it was added, deleted or renamed, and its unified diff. This is the tool to call before reviewing, approving or commenting on a merge request: the new_path values and the line numbers inside each diff hunk are what Create Merge Request Comment and Create Merge Request Review need to anchor an inline comment. Large merge requests can be trimmed with Paths (only files under the given prefixes) and Max Files . Watch for too_large: true or collapsed: true on a file — GitLab omits or shortens those diffs, so do not conclude a file is unchanged. Use Get Merge Request for metadata and merge readiness, and Get Merge Request Commits for the commit history. See the documentation (https://pipedream.com/apps/gitlab/actions/get-merge-request-diffs)
- action : Get Repo Branch — Get a single project repository branch. See the documentation (https://pipedream.com/apps/gitlab/actions/get-repo-branch)
- action : List Commits — List commits in a repository branch. See the documentation (https://pipedream.com/apps/gitlab/actions/list-commits)
- action : List Group ID Options — Retrieves available options for the Group ID field. (https://pipedream.com/apps/gitlab/actions/list-group-id-options)
- action : List Group Path Options — Retrieves available options for the Group Path field. (https://pipedream.com/apps/gitlab/actions/list-group-path-options)
- action : List Groups — List all groups. See the documentation (https://pipedream.com/apps/gitlab/actions/list-groups)
- action : List Merge Request Discussions — List the comment threads on a merge request — both general comments and inline threads anchored to lines of the diff. Use this to read existing review feedback before adding your own, to find what a reviewer objected to, or to get the id of a thread so you can reply to it with Create Merge Request Comment or close it with Resolve Merge Request Thread . Each thread's notes carry resolvable , resolved and, for inline threads, the position (file path and line) they are attached to. GitLab records label changes, assignments and other bookkeeping as system notes; those are filtered out by default because they are rarely what a reader wants — set Include System Notes to true to see them. Set Only Unresolved to true to get just the threads still needing attention. See the documentation (https://pipedream.com/apps/gitlab/actions/list-merge-request-discussions)
- action : List Merge Requests — List merge requests, filtered by project, group, state, author, assignee, reviewer, labels or target branch. Use this for any "what merge requests are …" question — open MRs in a project, MRs waiting on my review (set Scope to reviews_for_me ), MRs assigned to me, MRs targeting a release branch. Use Search Merge Requests instead when you have text to match against a title or description. Set Project to scope to one project, Group to scope to a whole group, or leave both blank to search across everything the authenticated user can see — note that with both blank GitLab defaults Scope to created_by_me , so pass all to widen it. Results are summarized by default; set Detail to full for the complete merge request objects. The returned iid is what every other merge request tool needs. See the documentation (https://pipedream.com/apps/gitlab/actions/list-merge-requests)
- action : List Project ID Options — Retrieves available options for the Project ID field. (https://pipedream.com/apps/gitlab/actions/list-project-id-options)
- action : List Project Labels — List the labels defined in a project. Call this before applying labels with Create Merge Request : GitLab creates a label it does not recognize rather than rejecting it, so an invented or mis-cased name silently adds a new project label instead of applying the intended one. Each result's name is the value to pass back; the description is worth reading because label names are often abbreviations. Narrow a long list with Search . See the documentation (https://pipedream.com/apps/gitlab/actions/list-project-labels)
- action : List Project Members — List all members of a project. See the documentation (https://pipedream.com/apps/gitlab/actions/list-project-members)
- action : List Projects — List or search GitLab projects, optionally filtering by search term, membership, or ownership. Use this to discover projects (and their IDs) before acting on them with other GitLab actions. Supports ordering by name , path , creation/update time, star count, last activity, or search similarity , plus pagination. The similarity order requires a Search term. See the documentation (https://pipedream.com/apps/gitlab/actions/list-projects)
- action : List Repo Branches — Get a list of repository branches from a project. See the documentation (https://pipedream.com/apps/gitlab/actions/list-repo-branches)
- action : Resolve Merge Request Thread — Mark a merge request thread as resolved, or reopen a resolved one by setting Resolved to false . Use this after acting on a piece of review feedback — resolving threads is what clears a merge request's blocking_discussions_resolved flag so it can merge. Get the Discussion ID from List Merge Request Discussions (set its Only Unresolved to true to see just the threads still open). Only threads that are resolvable can be resolved: plain comments on the merge request as a whole are not, and GitLab rejects the attempt. See the documentation (https://pipedream.com/apps/gitlab/actions/resolve-merge-request-thread)
- action : Search Issues — Search for issues in a repository with a query. See the documentation (https://pipedream.com/apps/gitlab/actions/search-issues)
- action : Search Merge Requests — Find merge requests whose title or description matches a search term. Use this when the user refers to a merge request by what it is about ("the MR about the Redis cache refactor", "the payments migration MR") rather than by number - it is the fastest way to turn a description into the iid that every other merge request tool needs. ALWAYS set Project (or Group ) when you know which one the user means: a project-scoped search returns in well under a second, whereas an unscoped search scans every project the account can access and, on accounts that belong to many projects, can take tens of seconds and time out (HTTP 408). Leave both blank only when the project is genuinely unknown. Use List Merge Requests instead when there is no text to match and you only want to filter by state, author, reviewer or branch. Matching is case-insensitive substring, not fuzzy - prefer one or two distinctive words over a whole sentence. See the documentation (https://pipedream.com/apps/gitlab/actions/search-merge-requests)
- action : Update Epic — Updates an epic. See the documentation (https://pipedream.com/apps/gitlab/actions/update-epic)
- action : Update Issue — Updates an existing project issue. See the documentation (https://pipedream.com/apps/gitlab/actions/update-issue)
- trigger : New Commit (Instant) — Emit new event when a new commit is pushed to a branch (https://pipedream.com/apps/gitlab/triggers/new-commit)
- trigger : New Branch (Instant) — Emit new event when a new branch is created (https://pipedream.com/apps/gitlab/triggers/new-branch)
- trigger : New Project — Emit new event when a project (i.e. repository) is created (https://pipedream.com/apps/gitlab/triggers/new-project)
- trigger : New Audit Event (Instant) — Emit new event when a new audit event is created (https://pipedream.com/apps/gitlab/triggers/new-audit-event)
- trigger : New Commit Comment (Instant) — Emit new event when a commit receives a comment (https://pipedream.com/apps/gitlab/triggers/new-commit-comment)
- trigger : New Issue (Instant) — Emit new event when an issue is created in a project (https://pipedream.com/apps/gitlab/triggers/new-issue)
- trigger : New Mention (Instant) — Emit new event when you are @mentioned in a new commit, comment, issue or pull request (https://pipedream.com/apps/gitlab/triggers/new-mention)
- trigger : New Merge Request (Instant) — Emit new event when a merge request is created (https://pipedream.com/apps/gitlab/triggers/new-merge-request)
- trigger : New Milestone — Emit new event when a milestone is created in a project (https://pipedream.com/apps/gitlab/triggers/new-milestone)
- trigger : New Review Request (Instant) — Emit new event when a reviewer is added to a merge request (https://pipedream.com/apps/gitlab/triggers/new-review-request)