# Gérer les automatisations (/fr/automations/manage)

<!-- agent-signals: reading_time_min: 18 · est_tokens: 7350 · updated: 2026-09-23 -->
Related: [Créer une automatisation personnalisée](/fr/automations/create.md), [Intégrations pour l'agent et les automatisations](/fr/automations/integrations.md), [Automatisations prédéfinies](/fr/automations/reference.md)

<div id="prerequisites">
  ## Prérequis [#prérequis]
</div>

* Un projet Mintlify connecté à un dépôt GitHub ou GitLab
* Pour GitHub : la [GitHub App Mintlify](/fr/deploy/github) installée sur chaque dépôt que vous prévoyez d'utiliser dans l'automatisation
* Pour GitLab : un compte GitLab connecté (voir [Configuration GitLab](#gitlab-setup) ci-dessous)

<Tip>
  Vous pouvez également créer, lister et supprimer des automatisations depuis le terminal avec [`mint automations`](/fr/cli/commands#mint-automations). La CLI est utile pour les scripts et la CI. Le dashboard est le moyen le plus simple de configurer et de surveiller les exécutions d'automatisations.
</Tip>

<div id="enable-an-automation">
  ## Activer une automatisation [#activer-une-automatisation]
</div>

1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard.
2. Cliquez sur le bouton bascule à côté d'une automatisation pour l'activer.

   <Frame>
     <img src="/_assets/51f77decb673d7aaabaeddc2caff533add9f441ec6492addd7a10486739716b9" alt="Le dashboard des automatisations." className="block dark:hidden" />

     <img src="/_assets/830722b9c9a2903e4c37359dab7e7336499bd4af27085619b776a7f337d80d19" alt="Le dashboard des automatisations." className="hidden dark:block" />
   </Frame>

   Si l'automatisation peut s'exécuter avec les paramètres par défaut, elle s'active immédiatement. Sinon, la page de configuration de l'automatisation s'ouvre pour vous permettre de remplir les configurations requises.
3. Si la page de configuration s'ouvre, remplissez les champs requis et cliquez sur **Save**.

Pour modifier les paramètres d'une automatisation active, cliquez sur le bouton <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M15.5 12C15.5 13.933 13.933 15.5 12 15.5C10.067 15.5 8.5 13.933 8.5 12C8.5 10.067 10.067 8.5 12 8.5C13.933 8.5 15.5 10.067 15.5 12Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M21.011 14.0965C21.5329 13.9558 21.7939 13.8854 21.8969 13.7508C22 13.6163 22 13.3998 22 12.9669V11.0332C22 10.6003 22 10.3838 21.8969 10.2493C21.7938 10.1147 21.5329 10.0443 21.011 9.90358C19.0606 9.37759 17.8399 7.33851 18.3433 5.40087C18.4817 4.86799 18.5509 4.60156 18.4848 4.44529C18.4187 4.28902 18.2291 4.18134 17.8497 3.96596L16.125 2.98673C15.7528 2.77539 15.5667 2.66972 15.3997 2.69222C15.2326 2.71472 15.0442 2.90273 14.6672 3.27873C13.208 4.73448 10.7936 4.73442 9.33434 3.27864C8.95743 2.90263 8.76898 2.71463 8.60193 2.69212C8.43489 2.66962 8.24877 2.77529 7.87653 2.98663L6.15184 3.96587C5.77253 4.18123 5.58287 4.28891 5.51678 4.44515C5.45068 4.6014 5.51987 4.86787 5.65825 5.4008C6.16137 7.3385 4.93972 9.37763 2.98902 9.9036C2.46712 10.0443 2.20617 10.1147 2.10308 10.2492C2 10.3838 2 10.6003 2 11.0332V12.9669C2 13.3998 2 13.6163 2.10308 13.7508C2.20615 13.8854 2.46711 13.9558 2.98902 14.0965C4.9394 14.6225 6.16008 16.6616 5.65672 18.5992C5.51829 19.1321 5.44907 19.3985 5.51516 19.5548C5.58126 19.7111 5.77092 19.8188 6.15025 20.0341L7.87495 21.0134C8.24721 21.2247 8.43334 21.3304 8.6004 21.3079C8.76746 21.2854 8.95588 21.0973 9.33271 20.7213C10.7927 19.2644 13.2088 19.2643 14.6689 20.7212C15.0457 21.0973 15.2341 21.2853 15.4012 21.3078C15.5682 21.3303 15.7544 21.2246 16.1266 21.0133L17.8513 20.034C18.2307 19.8187 18.4204 19.711 18.4864 19.5547C18.5525 19.3984 18.4833 19.132 18.3448 18.5991C17.8412 16.6616 19.0609 14.6226 21.011 14.0965Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> de paramètres sur sa carte pour ouvrir sa page de configuration. Utilisez le bouton bascule dans l'en-tête de la page pour activer ou désactiver l'automatisation, et cliquez sur **Save** pour appliquer vos modifications.

<div id="configurations">
  ## Configurations [#configurations]
</div>

La page de configuration de chaque automatisation regroupe les paramètres dans les sections **Trigger**, **Scope** et **Advanced options**.

<div id="trigger">
  ### Déclencheur [#déclencheur]
</div>

Chaque automatisation possède un déclencheur par défaut qui contrôle son moment d'exécution. Pour changer le déclencheur, sélectionnez un autre type de déclencheur sur la page de configuration de l'automatisation.

* **Mise à jour de contenu** : s'exécute chaque fois que vous poussez du contenu vers le dépôt de votre projet, y compris les fusions de pull requests et les pushes directs.
* **Modification de code** : s'exécute lorsqu'une pull request est fusionnée dans un dépôt de code source connecté. Vous devez spécifier au moins un dépôt source. Cliquez sur **Add repo** pour déclencher l'automatisation sur des pull requests provenant de plusieurs dépôts. Pour chaque dépôt, vous pouvez éventuellement définir **Exclude author** pour ignorer les pull requests d'un auteur spécifique, et **Listening to changes in** pour ne déclencher que sur les pull requests dont les modifications se trouvent sous un chemin spécifique.
* **Calendrier personnalisé** : s'exécute selon un calendrier récurrent que vous définissez. Choisissez un préréglage (**Daily**, **Every Monday**, **Every Friday** ou **Twice weekly**) et une heure de début, ou sélectionnez **Custom cron** et saisissez une expression cron standard à 5 champs (`minute heure jour mois jour_de_la_semaine`). Les valeurs cron sont stockées en UTC ; le dashboard convertit les heures des préréglages depuis et vers votre fuseau horaire local. Les automatisations sont mises en file d'attente dans les 10 minutes suivant l'heure planifiée.
* **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée, ou lorsqu'un nouveau message de premier niveau est publié dans un canal Slack sélectionné. Disponible pour les automatisations personnalisées. Sélectionnez l'intégration et l'événement, puis remplissez les champs supplémentaires affichés. Pour les déclencheurs Slack, choisissez un ou plusieurs canaux auxquels l'[application Mintlify pour Slack](/fr/agent/slack) a été ajoutée.
* **Webhook** : s'exécute lorsqu'une requête `POST` authentifiée atteint le point de terminaison webhook de l'automatisation. Disponible uniquement pour les automatisations personnalisées. Enregistrez d'abord l'automatisation ; la carte du déclencheur affiche alors l'URL du webhook et une action **Copy auth header** pour l'en-tête `Authorization: Bearer <api-key>`. Fournissez une clé d'API d'organisation non expirée avec accès en écriture depuis la page [API keys](https://app.mintlify.com/settings/organization/api-keys). Utilisez-le pour déclencher une exécution depuis un pipeline CI/CD, un script de publication ou un outil interne. Consultez [Déclencher un webhook d'automatisation](/fr/api/automations/webhook) pour le point de terminaison et les limites de débit.

<div id="filter-code-change-triggers">
  #### Filtrer les déclencheurs de modification de code [#filtrer-les-déclencheurs-de-modification-de-code]
</div>

Pour les automatisations avec un déclencheur **Modification de code** sur GitHub, chaque dépôt source apparaît dans sa propre carte sur la page de configuration. Vous pouvez ajouter jusqu'à 50 dépôts par automatisation. Dans **Show advanced options** sur chaque carte, vous pouvez restreindre le moment où l'automatisation s'exécute pour ce dépôt :

* **Listening to changes in** : ajoutez les chemins que la pull request doit modifier pour que l'automatisation s'exécute. Les chemins peuvent être des fichiers, des dossiers ou des motifs glob (par exemple, `docs/**/*.mdx`). Les suggestions proviennent des fichiers suivis du dépôt ; vous pouvez également saisir un chemin personnalisé.
* **Excluding PRs from** : ajoutez les noms d'utilisateur GitHub ou les comptes de bot dont les pull requests ne doivent pas déclencher l'automatisation. Utile pour ignorer les fusions provenant de comptes d'automatisation. Les suggestions proviennent des contributeurs récents ; vous pouvez également saisir un nom d'utilisateur personnalisé.

Chaque dépôt prend en charge jusqu'à 20 chemins et 20 auteurs exclus. Changer le dépôt d'une carte efface ses filtres. Les dépôts sources GitLab ne prennent pas en charge les filtres par dépôt et continuent d'utiliser un sélecteur de dépôt unique.

<div id="update-mode">
  ### Mode de mise à jour [#mode-de-mise-à-jour]
</div>

Chaque automatisation possède un mode par défaut pour effectuer les mises à jour. Soit fusionner directement les modifications dans votre dépôt de contenu, soit ouvrir une pull request pour relecture.

Sélectionnez le mode dans la section **After automation runs** de la page de configuration de l'automatisation. Sélectionnez **Update and merge changes** pour fusionner les modifications automatiquement. Sélectionnez **Modify and wait for review** pour exiger une relecture avant que les modifications soient mises en ligne.

<Note>
  Pour les dépôts GitHub, les mises à jour automatiques nécessitent que la GitHub App Mintlify dispose d'autorisations de contournement (bypass) sur chaque ensemble de règles ciblant votre branche de déploiement, y compris les ensembles de règles au niveau de l'organisation et du dépôt. Consultez [Configurer l'automerge](/fr/guides/configure-automerge) pour les instructions d'installation.

  Pour les dépôts GitLab, l'automerge utilise la connexion OAuth GitLab et nécessite au moins le rôle Maintainer sur chaque projet.
</Note>

<div id="context-repositories">
  ### Dépôts de contexte [#dépôts-de-contexte]
</div>

Pour les automatisations personnalisées et certaines automatisations prédéfinies, vous pouvez ajouter des dépôts de contexte — des dépôts de code source supplémentaires que l'agent lit lorsque l'automatisation s'exécute. C'est utile lorsque le prompt de votre automatisation fait référence à du code, des API ou d'autres contenus qui se trouvent en dehors de votre dépôt de projet.

Vous pouvez ajouter jusqu'à 10 dépôts de contexte par automatisation. Pour chaque dépôt GitHub, installez la GitHub App Mintlify. Ajoutez des dépôts sur la page [GitHub App settings](https://app.mintlify.com/settings/organization/github-app).

<div id="integrations">
  ### Intégrations [#intégrations]
</div>

Pour les automatisations personnalisées et les autres automatisations prédéfinies compatibles, vous pouvez activer des [intégrations](/fr/automations/integrations) afin que l'agent récupère du contexte depuis des outils partagés comme Notion, Jira ou Linear.

Pour activer des intégrations sur une automatisation, ouvrez sa page de configuration, développez **Advanced options** et sélectionnez les intégrations que vous souhaitez utiliser dans **Integrations**.

Si vous sélectionnez **Intégration** comme déclencheur, l'intégration déclencheuse est automatiquement ajoutée comme outil. Consultez [Intégrations](/fr/automations/integrations) pour les portées, événements et autorisations.

<div id="slack-notifications">
  ### Notifications Slack [#notifications-slack]
</div>

Envoyez des messages Slack à un ou plusieurs canaux lorsque les automatisations s'exécutent.

Pour activer les notifications Slack :

1. Installez l'[application Slack Mintlify](/fr/agent/slack) dans votre espace de travail.
2. Cliquez sur **Configure Slack** sur la page [Automations](https://app.mintlify.com/products/automations) de votre dashboard.
3. Sélectionnez un ou plusieurs canaux vers lesquels envoyer les notifications.
4. Cliquez sur **Save changes**.

Une fois activé, Mintlify publie dans les canaux sélectionnés lorsque :

* Une automatisation ouvre une pull request pour relecture.
* Une pull request d'automatisation attend une relecture depuis trois jours.
* Une automatisation fusionne une pull request, ou échoue à se terminer.

<div id="email-notifications">
  ### Notifications par e-mail [#notifications-par-e-mail]
</div>

Pour recevoir un e-mail lorsqu'une exécution d'automatisation réussit ou échoue, activez les e-mails d'exécution d'automatisation depuis la page [Notifications](/fr/dashboard/notifications) de votre dashboard.

<div id="instructions">
  ### Instructions [#instructions]
</div>

Ajoutez des instructions facultatives dans la section **Scope** de la page de configuration. Pour les automatisations prédéfinies, ce champ s'appelle **Additional prompts** et s'ajoute au prompt de base de l'automatisation à chaque exécution. Pour les automatisations personnalisées, ce champ s'appelle **Prompt** et constitue l'intégralité des instructions de l'automatisation. Utilisez-le pour ajuster le style, le ton ou d'autres comportements spécifiques au projet sans modifier la logique principale de l'automatisation.

<div id="target-languages">
  ### Langues cibles [#langues-cibles]
</div>

Lorsque vous activez l'automatisation **Translate content**, sélectionnez une ou plusieurs langues à maintenir en synchronisation avec votre contenu source.

* Mintlify lit les [langues](/fr/organize/navigation#languages) définies dans votre `docs.json` pour identifier votre langue par défaut et présélectionne les langues cibles déjà configurées.
* Vous devez sélectionner au moins une langue cible pour enregistrer l'automatisation.
* Vous ne pouvez pas sélectionner la langue source comme cible.

Vous pouvez ajouter des langues cibles à tout moment en ouvrant la page de configuration de l'automatisation et en modifiant le champ **Translate to**.

## Configuration GitLab [#configuration-gitlab]

Pour utiliser des dépôts GitLab dans une automatisation, connectez chaque projet via la page de paramètres [OAuth GitLab](https://app.mintlify.com/settings/organization/gitlab-oauth). Connectez chaque dépôt que l'automatisation utilise — votre dépôt de documentation et tous les dépôts de déclenchement ou de contexte. Vous devez disposer au minimum du rôle Mainteneur sur chaque projet.

<Note>
  Les automatisations nécessitent un forfait GitLab payant. L'agent utilise des jetons d'accès de projet à courte durée de vie pour l'accès aux dépôts, ce que le forfait gratuit de GitLab ne prend pas en charge.
</Note>

<div id="disable-an-automation">
  ## Désactiver une automatisation [#désactiver-une-automatisation]
</div>

1. Accédez à la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard.
2. Cliquez sur le bouton bascule à côté d'une automatisation pour la désactiver.

Lorsque vous réactivez une automatisation planifiée ou modifiez son calendrier, Mintlify recalcule la prochaine heure d'exécution à partir de l'heure actuelle. Les automatisations désactivées ne conservent pas d'heure d'exécution en attente.

<div id="delete-an-automation">
  ## Supprimer une automatisation [#supprimer-une-automatisation]
</div>

Vous pouvez supprimer les automatisations personnalisées depuis le dashboard. Les automatisations prédéfinies ne peuvent pas être supprimées depuis le dashboard. Désactivez-les à la place, ou utilisez la CLI pour les supprimer.

1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard.
2. Cliquez sur le bouton <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M15.5 12C15.5 13.933 13.933 15.5 12 15.5C10.067 15.5 8.5 13.933 8.5 12C8.5 10.067 10.067 8.5 12 8.5C13.933 8.5 15.5 10.067 15.5 12Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M21.011 14.0965C21.5329 13.9558 21.7939 13.8854 21.8969 13.7508C22 13.6163 22 13.3998 22 12.9669V11.0332C22 10.6003 22 10.3838 21.8969 10.2493C21.7938 10.1147 21.5329 10.0443 21.011 9.90358C19.0606 9.37759 17.8399 7.33851 18.3433 5.40087C18.4817 4.86799 18.5509 4.60156 18.4848 4.44529C18.4187 4.28902 18.2291 4.18134 17.8497 3.96596L16.125 2.98673C15.7528 2.77539 15.5667 2.66972 15.3997 2.69222C15.2326 2.71472 15.0442 2.90273 14.6672 3.27873C13.208 4.73448 10.7936 4.73442 9.33434 3.27864C8.95743 2.90263 8.76898 2.71463 8.60193 2.69212C8.43489 2.66962 8.24877 2.77529 7.87653 2.98663L6.15184 3.96587C5.77253 4.18123 5.58287 4.28891 5.51678 4.44515C5.45068 4.6014 5.51987 4.86787 5.65825 5.4008C6.16137 7.3385 4.93972 9.37763 2.98902 9.9036C2.46712 10.0443 2.20617 10.1147 2.10308 10.2492C2 10.3838 2 10.6003 2 11.0332V12.9669C2 13.3998 2 13.6163 2.10308 13.7508C2.20615 13.8854 2.46711 13.9558 2.98902 14.0965C4.9394 14.6225 6.16008 16.6616 5.65672 18.5992C5.51829 19.1321 5.44907 19.3985 5.51516 19.5548C5.58126 19.7111 5.77092 19.8188 6.15025 20.0341L7.87495 21.0134C8.24721 21.2247 8.43334 21.3304 8.6004 21.3079C8.76746 21.2854 8.95588 21.0973 9.33271 20.7213C10.7927 19.2644 13.2088 19.2643 14.6689 20.7212C15.0457 21.0973 15.2341 21.2853 15.4012 21.3078C15.5682 21.3303 15.7544 21.2246 16.1266 21.0133L17.8513 20.034C18.2307 19.8187 18.4204 19.711 18.4864 19.5547C18.5525 19.3984 18.4833 19.132 18.3448 18.5991C17.8412 16.6616 19.0609 14.6226 21.011 14.0965Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> de paramètres sur la carte de l'automatisation personnalisée pour ouvrir sa page de configuration.
3. Cliquez sur **Delete automation** en bas de la page et confirmez.

Pour supprimer n'importe quelle automatisation depuis le terminal, utilisez [`mint automations`](/fr/cli/commands#mint-automations). La suppression est définitive et ne peut pas être annulée.

<div id="run-an-automation-manually">
  ## Exécuter une automatisation manuellement [#exécuter-une-automatisation-manuellement]
</div>

Vous pouvez déclencher une automatisation à la demande sans attendre sa prochaine exécution planifiée ou déclenchée par un événement.

1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard.
2. Cliquez sur le bouton <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M15.5 12C15.5 13.933 13.933 15.5 12 15.5C10.067 15.5 8.5 13.933 8.5 12C8.5 10.067 10.067 8.5 12 8.5C13.933 8.5 15.5 10.067 15.5 12Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M21.011 14.0965C21.5329 13.9558 21.7939 13.8854 21.8969 13.7508C22 13.6163 22 13.3998 22 12.9669V11.0332C22 10.6003 22 10.3838 21.8969 10.2493C21.7938 10.1147 21.5329 10.0443 21.011 9.90358C19.0606 9.37759 17.8399 7.33851 18.3433 5.40087C18.4817 4.86799 18.5509 4.60156 18.4848 4.44529C18.4187 4.28902 18.2291 4.18134 17.8497 3.96596L16.125 2.98673C15.7528 2.77539 15.5667 2.66972 15.3997 2.69222C15.2326 2.71472 15.0442 2.90273 14.6672 3.27873C13.208 4.73448 10.7936 4.73442 9.33434 3.27864C8.95743 2.90263 8.76898 2.71463 8.60193 2.69212C8.43489 2.66962 8.24877 2.77529 7.87653 2.98663L6.15184 3.96587C5.77253 4.18123 5.58287 4.28891 5.51678 4.44515C5.45068 4.6014 5.51987 4.86787 5.65825 5.4008C6.16137 7.3385 4.93972 9.37763 2.98902 9.9036C2.46712 10.0443 2.20617 10.1147 2.10308 10.2492C2 10.3838 2 10.6003 2 11.0332V12.9669C2 13.3998 2 13.6163 2.10308 13.7508C2.20615 13.8854 2.46711 13.9558 2.98902 14.0965C4.9394 14.6225 6.16008 16.6616 5.65672 18.5992C5.51829 19.1321 5.44907 19.3985 5.51516 19.5548C5.58126 19.7111 5.77092 19.8188 6.15025 20.0341L7.87495 21.0134C8.24721 21.2247 8.43334 21.3304 8.6004 21.3079C8.76746 21.2854 8.95588 21.0973 9.33271 20.7213C10.7927 19.2644 13.2088 19.2643 14.6689 20.7212C15.0457 21.0973 15.2341 21.2853 15.4012 21.3078C15.5682 21.3303 15.7544 21.2246 16.1266 21.0133L17.8513 20.034C18.2307 19.8187 18.4204 19.711 18.4864 19.5547C18.5525 19.3984 18.4833 19.132 18.3448 18.5991C17.8412 16.6616 19.0609 14.6226 21.011 14.0965Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> de paramètres sur la carte de l'automatisation pour ouvrir sa page de configuration.
3. Cliquez sur le bouton d'exécution (**Test run** ou **Run now**, selon l'automatisation).
4. Choisissez la portée de l'exécution.
   * **Since a date** : examine les modifications depuis la date sélectionnée jusqu'à l'heure actuelle. La date par défaut est celle de la dernière exécution de l'automatisation, ou il y a sept jours si elle n'a jamais été exécutée.
   * **Everything** : examine l'ensemble du site ou de l'historique du dépôt. Cette portée prend généralement plus de temps qu'une exécution ciblée.
   * **Specific pull request** : limite l'exécution à une seule pull request dans un dépôt sélectionné.
5. Cliquez sur **Run now**.

Les exécutions manuelles enregistrent la configuration actuelle de l'automatisation et activent l'automatisation avant de démarrer. Elles sont décomptées de votre utilisation de crédits et apparaissent dans l'historique des exécutions aux côtés des exécutions déclenchées automatiquement.

Vous pouvez exécuter manuellement les automatisations avec des déclencheurs de calendrier, de mise à jour de contenu ou de modification de code. Les automatisations déclenchées par une intégration ou un webhook ne s'exécutent que lorsque leur déclencheur se déclenche, leur bouton d'exécution est donc indisponible. L'automatisation **Translate content** peut toujours être exécutée manuellement.

<div id="trigger-a-scheduled-automation-via-api">
  ## Déclencher une automatisation planifiée via l'API [#déclencher-une-automatisation-planifiée-via-lapi]
</div>

Pour les automatisations avec un déclencheur **Calendrier personnalisé**, vous pouvez démarrer une exécution depuis vos propres outils au lieu d'attendre la prochaine heure planifiée. Utilisez l'endpoint [Trigger automation](/fr/api/automations/trigger) pour déclencher une exécution depuis un pipeline CI/CD, un script de version ou tout service capable de faire une requête HTTP authentifiée.

Les exécutions déclenchées par API se comportent exactement comme les exécutions planifiées : elles récupèrent tout ce qui a changé depuis la dernière exécution terminée, sont décomptées de votre utilisation de crédits et apparaissent dans l'historique des exécutions.

<div id="trigger-a-webhook-automation">
  ## Déclencher une automatisation webhook [#déclencher-une-automatisation-webhook]
</div>

Les automatisations personnalisées avec un déclencheur **Webhook** s'exécutent lorsqu'une requête `POST` authentifiée arrive sur leur endpoint webhook. Après avoir enregistré l'automatisation, ouvrez sa page de configuration pour copier l'URL du webhook et voir le modèle d'en-tête `Authorization: Bearer <api-key>`. Remplacez `<api-key>` par une clé d'API d'organisation non expirée avec accès en écriture, créée sur la page [API keys](https://app.mintlify.com/settings/organization/api-keys). Les automatisations ne créent, ne stockent ni ne font tourner de clés.

Les exécutions déclenchées via le webhook utilisent le prompt enregistré de l'automatisation, lisent l'historique complet du dépôt et apparaissent dans l'historique des exécutions avec le libellé **Webhook request**. Consultez [Déclencher un webhook d'automatisation](/fr/api/automations/webhook) pour le format de la requête, les codes de réponse et les limites de débit.

<div id="view-run-history">
  ## Consulter l'historique des exécutions [#consulter-lhistorique-des-exécutions]
</div>

L'onglet [Runs](https://app.mintlify.com/products/automations?tab=runs) de la page des automatisations affiche la liste de toutes les exécutions de toutes les automatisations.

Une exécution correspond à une seule exécution d'une automatisation. Une exécution peut créer une nouvelle pull request, mettre à jour une pull request existante, échouer ou ne rien trouver à modifier.

1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations?tab=runs) dans votre dashboard.
2. Utilisez les menus déroulants pour filtrer par automatisations spécifiques ou par statut.

Chaque résultat affiche l'un des statuts suivants :

* **Review needed** : l'agent a terminé l'exécution, mais les modifications doivent être relues et fusionnées par une personne de votre équipe.
* **Running** : l'agent travaille activement sur la tâche d'automatisation.
* **Accepted** : l'agent a terminé l'exécution et les modifications ont été fusionnées dans votre dépôt.
* **Closed** : l'agent a terminé l'exécution, mais quelqu'un a rejeté les modifications.
* **Failed** : l'agent n'a pas pu terminer l'exécution.
* **No action needed** : l'agent a terminé l'exécution mais n'a rien trouvé à mettre à jour.
* **Modified PR** : le résultat a ajouté des modifications à une pull request ouverte par une exécution précédente.

Vous pouvez agir sur les résultats directement depuis la liste. Pour les exécutions en attente de relecture, cliquez sur **Accept** pour fusionner les modifications ou sur **Preview** pour ouvrir le [preview deployment](/fr/deploy/preview-deployments) de la branche de l'exécution. Pour ouvrir la branche de l'exécution dans l'éditeur, cliquez sur **View changes** ou ouvrez le menu <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> puis cliquez sur **Open in editor**. Pour les résultats en échec, cliquez sur **Re-trigger** pour relancer l'exécution.

Le bouton **Preview** n'apparaît que lorsqu'un preview deployment est lié à l'exécution. Les preview deployments expirent après une période d'inactivité ; une fois expirés, le bouton est désactivé.

<div id="resolve-merge-conflicts">
  ### Résoudre les conflits de fusion [#résoudre-les-conflits-de-fusion]
</div>

Si la pull request d'une exécution entre en conflit avec votre branche de déploiement, cliquer sur **Accept** ouvre une boîte de dialogue proposant de résoudre les conflits pour vous. Cliquez sur **Resolve and merge** pour que l'agent fusionne les derniers changements de la branche de déploiement dans la branche de la pull request, résolve les conflits et fusionne automatiquement la pull request. L'exécution s'affiche comme **Running** pendant que l'agent travaille, puis passe à **Accepted** une fois la pull request fusionnée. Si l'agent ne peut pas résoudre les conflits, résolvez-les manuellement dans votre dépôt, puis cliquez à nouveau sur **Accept**.

Pour voir le prompt d'une exécution, les fichiers qu'elle a lus ou modifiés, et toute pull request, cliquez sur le menu d'actions <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> de l'exécution, puis cliquez sur **View run details**.

<div id="continue-a-run-in-the-editor">
  ## Poursuivre une exécution dans l'éditeur [#poursuivre-une-exécution-dans-léditeur]
</div>

Lorsqu'une automatisation se termine et crée des modifications sur une branche, vous pouvez ouvrir ces modifications directement dans l'éditeur pour les examiner, les affiner ou les publier.

1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard.
2. Dans l'onglet **Runs**, cliquez sur **View changes** sur l'exécution, ou ouvrez le menu d'actions <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> et cliquez sur **Open in editor**. Ces deux options ne sont disponibles que tant que la pull request de l'exécution reste ouverte.

L'éditeur s'ouvre sur la branche de l'automatisation. Demandez à l'agent de l'éditeur d'affiner ou d'étendre ce travail ; l'agent dispose d'un contexte complet sur le prompt de l'automatisation, un résumé des modifications et les pages modifiées, vous n'avez donc pas besoin de réexpliquer le contexte.