Fusionner une merge request avec l'API GitLab
Fusionne une merge request et la renvoie. Avec auto_merge true, elle est fusionnée une fois le pipeline et les vérifications réussis. Répond 405 quand elle ne peut pas être fusionnée, 409 quand sha ne correspond pas à la branche source et 422 quand la fusion échoue.
- Identifiant
- gitlab_merge_merge_request
L'appel
POST https://connect.reportei.com/api/tools/gitlab_merge_merge_request/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"id": "<id>",
"merge_request_iid": 1
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| id | string | Oui | The id of the project from List projects, or its path_with_namespace, such as group/project. |
| merge_request_iid | integer | Oui | The iid of the merge request from List merge requests, not its id. |
| auto_merge | boolean | Non | Merges later, when the pipeline and the other checks pass, instead of now. |
| squash | boolean | Non | Squashes the commits into one. |
| should_remove_source_branch | boolean | Non | Deletes the source branch after the merge. |
| merge_commit_message | string | Non | Message of the merge commit. |
| squash_commit_message | string | Non | Message of the squashed commit. |
| sha | string | Non | The sha of Get merge request. The merge only happens if the source branch still points to it. Some groups require it. |
Connexions possibles
Votre client connecte son compte GitLab une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/gitlab, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/gitlab_merge_merge_request. Il devient la définition de tool de votre agent sans conversion.
Autres tools GitLab
- Lister les projetsGETListe les projets, du plus récent au plus ancien. Envoyez membership true pour n'obtenir que les projets du compte : sans cela, GitLab.com renvoie tous les projets publics. Chaque élément a id et path_with_namespace, que les autres outils prennent comme project. Paginez avec page et per_page : une page avec moins d'éléments que per_page est la dernière.
- Lister les membres du projetGETListe les membres d'un projet, y compris ceux hérités de ses groupes. Chaque élément a id, username et name : l'id est ce que demandent assignee_ids et reviewer_ids. Paginez avec page et per_page.
- Lister les issuesGETListe les issues de tous les projets que le compte peut voir. Par défaut, seulement les issues créées par le compte : envoyez scope assigned_to_me ou all pour les autres. Chaque élément a project_id et iid, que demandent les outils d'issues. Paginez avec page et per_page : une page avec moins d'éléments que per_page est la dernière.
- Lister les issues du projetGETListe les issues d'un projet, de la plus récente à la plus ancienne. Chaque élément a iid, le numéro de l'issue dans le projet, que demandent les outils d'issues. Paginez avec page et per_page : une page avec moins d'éléments que per_page est la dernière.
- Obtenir une issueGETRenvoie une issue d'un projet, avec title, description, state, labels, assignees, milestone et due date.
- Créer une issuePOSTCrée une issue dans un projet et la renvoie, avec son iid. Notifie les participants.
- Mettre à jour une issuePUTModifie une issue et la renvoie. Seuls les champs envoyés changent, et au moins un doit être envoyé. Pour la fermer ou la rouvrir, envoyez state_event. labels remplace tous les labels ; add_labels et remove_labels ne changent que ceux nommés.
- Lister les notes d'une issueGETListe les commentaires (notes) d'une issue, du plus récent au plus ancien par défaut, y compris les notes que GitLab écrit à chaque changement. Envoyez activity_filter only_comments pour ne garder que ce que les gens ont écrit. Paginez avec page et per_page.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
