> ## Documentation Index > Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Déclencher un webhook d'automatisation > Met en file d'attente une exécution d'automatisation personnalisée disposant d'un déclencheur webhook, au lieu d'attendre l'événement configuré du déclencheur. Utile pour exécuter des automatisations depuis des pipelines CI/CD, des scripts de publication ou tout autre système qui émet déjà des événements. Seules les automatisations personnalisées avec un déclencheur webhook peuvent être déclenchées ; les autres déclencheurs renvoient une réponse `404`. Authentifiez-vous avec une clé d'API d'organisation disposant d'un accès en écriture. Utilisez cet endpoint pour exécuter une automatisation personnalisée configurée avec un déclencheur **Webhook**. Chaque requête met en file d'attente une exécution qui utilise le prompt enregistré de l'automatisation et lit l'historique complet du dépôt. Les corps de requête sont ignorés. Cet endpoint ne prend en charge que les [automatisations personnalisées](/docs/fr/automations/create) avec un déclencheur webhook. Les automatisations prédéfinies et les automatisations avec tout autre déclencheur renvoient une réponse `404`. Pour déclencher à la demande une automatisation personnalisée planifiée, utilisez [Déclencher une automatisation](/docs/fr/api/automations/trigger).
## Cas d'utilisation
* **Pipelines CI/CD** : Exécutez une automatisation personnalisée à chaque fusion dans `main` ou après une publication, sans attendre une exécution planifiée. * **Événements de publication** : Exécutez une automatisation personnalisée depuis un script de publication lorsque vous créez un tag ou publiez une nouvelle version de SDK. * **Outillage interne** : Déclenchez des automatisations depuis des dashboards internes, des commandes Slack ou des tâches planifiées que vous exécutez déjà.
## Récupérer l'URL du webhook et l'en-tête d'authentification
Ouvrez la page [Automatisations](https://app.mintlify.com/products/automations) dans votre dashboard et cliquez sur le bouton de paramètres d'une automatisation personnalisée avec un déclencheur webhook. La carte du déclencheur affiche l'URL complète du webhook et une action **Copy auth header** pour le modèle d'en-tête `Authorization: Bearer `. Remplacez `` par une clé d'API d'organisation non expirée avec accès en écriture. Créez ou gérez les clés 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 à votre place.
## Exemple
Déclenchez une automatisation webhook depuis une GitHub Action chaque fois que du code est fusionné dans `main` : ```yaml .github/workflows/trigger-docs.yml theme={null} on: push: branches: [main] jobs: trigger: runs-on: ubuntu-latest steps: - run: | curl -fsS -X POST \ "https://api.mintlify.com/v2/workflow/$PROJECT_ID/$WORKFLOW_ID/webhook" \ -H "Authorization: Bearer ${{ secrets.MINTLIFY_API_KEY }}" env: PROJECT_ID: ${{ vars.MINTLIFY_PROJECT_ID }} WORKFLOW_ID: ${{ vars.MINTLIFY_WORKFLOW_ID }} ```
## Limites de débit
Cet endpoint partage une limite de débit avec [Trigger update](/docs/fr/api/update/trigger) et [Déclencher une automatisation](/docs/fr/api/automations/trigger) : jusqu'à 10 requêtes par tranche de 10 secondes et par organisation. Chaque exécution mise en file d'attente consomme des crédits au même rythme que n'importe quelle autre exécution d'automatisation personnalisée. Consultez [Tarification des crédits](/docs/fr/credits). ## OpenAPI ````yaml fr/admin-openapi.json POST /v2/workflow/{projectId}/{workflowSchemaId}/webhook openapi: 3.0.1 info: title: Mintlify Admin API description: >- Une API pour les opérations administratives, y compris les mises à jour de la documentation et la gestion des agents. version: 2.0.0 servers: - url: https://api.mintlify.com security: - bearerAuth: [] paths: /v2/workflow/{projectId}/{workflowSchemaId}/webhook: post: summary: Déclencher un webhook d'automatisation description: >- Met en file d'attente une exécution d'automatisation personnalisée disposant d'un déclencheur webhook, au lieu d'attendre l'événement configuré du déclencheur. Utile pour exécuter des automatisations depuis des pipelines CI/CD, des scripts de publication ou tout autre système qui émet déjà des événements. Seules les automatisations personnalisées avec un déclencheur webhook peuvent être déclenchées ; les autres déclencheurs renvoient une réponse `404`. Authentifiez-vous avec une clé d'API d'organisation disposant d'un accès en écriture. parameters: - name: projectId in: path required: true schema: type: string description: >- L'identifiant de votre projet. Copiez-le depuis la page [API keys](https://app.mintlify.com/settings/organization/api-keys) de votre dashboard. - name: workflowSchemaId in: path required: true schema: type: string description: >- L'identifiant de l'automatisation à déclencher. Copiez-le depuis le panneau de paramètres de l'automatisation sur la page [Automatisations](https://app.mintlify.com/products/automations) de votre dashboard. responses: '202': description: Exécution d'automatisation mise en file d'attente avec succès. content: application/json: schema: type: object properties: success: type: boolean runId: type: string description: >- L'identifiant de l'exécution d'automatisation mise en file d'attente. Il apparaît dans l'historique des exécutions sur la page [Automatisations](https://app.mintlify.com/products/automations). '400': description: L'identifiant de l'automatisation est mal formé. content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: >- Les crédits IA sont épuisés pour ce cycle de facturation. Passez à un plan supérieur ou attendez le renouvellement de vos crédits. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: >- L'automatisation est introuvable, n'est pas active, n'appartient pas à ce projet ou n'est pas configurée avec un déclencheur webhook. content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: La vérification des crédits a échoué. Réessayez la requête. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Error: type: object properties: error: type: string description: Message d’erreur. securitySchemes: bearerAuth: type: http scheme: bearer description: >- L'en-tête Authorization requiert un jeton Bearer. Utilisez une clé d'API administrateur. Il s'agit d'une clé secrète côté serveur. Générez-en une depuis la [page des clés d'API](https://dashboard.mintlify.com/settings/organization/api-keys) de votre Dashboard. ```` ## Related topics - [Vue d'ensemble des automatisations](/docs/fr/automations/index.md) - [Gérer les automatisations](/docs/fr/automations/manage.md) - [Référence des commandes de la CLI Mintlify](/docs/fr/cli/commands.md)