Comment mettre à jour votre workflow n8n pour Gamma API v1.0

Mise à jour critique : fin de vie de Gamma API v0.2

Si vous utilisez l’API de Gamma avec n8n pour générer automatiquement des présentations, vous devez mettre à jour vos workflows avant le 31 janvier 2026. Gamma abandonne ses endpoints API v0.2, et tout workflow utilisant encore l’ancienne version cessera de fonctionner après cette date.

La bonne nouvelle ? La migration est simple et ne prend que quelques minutes. Ce guide vous accompagne sur exactement ce qui doit changer.

Ce qui change dans Gamma API v1.0

Le changement le plus significatif dans l’API v1.0 concerne la façon dont les thèmes sont spécifiés. Au lieu d’utiliser des noms de thèmes lisibles par l’homme, la nouvelle API exige des identifiants de thèmes.

Ancienne méthode (v0.2) :

“themeName”: “Oasis”

Nouvelle méthode (v1.0) :

“themeId”: “theme_abc123xyz”

Ce changement améliore la stabilité de l’API et permet une sélection de thèmes plus précise, mais nécessite une mise à jour ponctuelle de vos workflows.

Migration étape par étape pour les utilisateurs n8n

Étape 1 : Ouvrez votre workflow n8n

Naviguez vers votre instance n8n et ouvrez le workflow qui utilise l’API Gamma. Recherchez le noeud HTTP Request qui effectue l’appel API vers Gamma.

Étape 2 : Mettez à jour l’URL de l’API

Dans votre noeud HTTP Request, changez l’URL de :

https://public-api.gamma.app/v0.2/generations

Vers :

https://public-api.gamma.app/v1.0/generations

Étape 3 : Obtenez votre identifiant de thème depuis Gamma

C’est l’étape cruciale. Voici comment trouver votre identifiant de thème :

1. Connectez-vous à votre compte Gamma sur gamma.app
2. Cliquez sur l’icône palette dans la barre de navigation pour ouvrir la Design Library
3. Trouvez le thème que vous souhaitez utiliser pour vos présentations
4. Cliquez sur les trois points (⋯) à côté du nom du thème
5. Sélectionnez “Copy theme ID for API” dans le menu

Votre identifiant de thème sera copié dans votre presse-papiers. Il ressemblera à quelque chose comme : theme_12345abcde

Étape 4 : Mettez à jour votre payload JSON

Dans votre noeud HTTP Request de n8n, trouvez la section du body JSON. Remplacez le paramètre themeName par themeId :

Avant :

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeName”: “Oasis”, “numCards”: 10 }

Après :

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeId”: “theme_12345abcde”, “numCards”: 10 }

Étape 5 : Sauvegardez et testez

Sauvegardez votre workflow mis à jour. Si vous utilisez n8n v2.0+, publiez la nouvelle version. Si vous êtes en v1.x, activez le workflow.

Lancez une exécution de test pour vérifier que tout fonctionne correctement avec la nouvelle version de l’API.

Alternative : utilisez le thème par défaut de Gamma

Si vous n’avez pas besoin d’un thème personnalisé spécifique, vous pouvez simplifier votre migration en supprimant entièrement le paramètre de thème. L’API v1.0 utilisera automatiquement le thème par défaut standard de Gamma :

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “numCards”: 10 }

Et si j’ai plusieurs workflows ?

Si vous avez plusieurs workflows n8n utilisant l’API Gamma, vous devrez mettre à jour chacun individuellement. Cependant, le processus est identique pour chaque workflow :

1. Mettez à jour l’URL de l’API vers v1.0
2. Remplacez themeName par themeId
3. Utilisez le même identifiant de thème dans tous les workflows (ou obtenez des identifiants différents si vous souhaitez des thèmes différents)

Pensez à documenter vos identifiants de thèmes dans un emplacement centralisé afin de pouvoir les référencer facilement lors de la création de nouveaux workflows.

Ressources supplémentaires

• Documentation officielle de l’API Gamma
• Centre d’aide de l’API Gamma

Besoin d’aide ?

Si vous rencontrez des problèmes pendant la migration, vérifiez que :

• Votre clé API n’a pas changé (elle devrait rester la même)
• Vous avez copié l’identifiant de thème complet depuis Gamma
• Vous utilisez la bonne URL de l’endpoint v1.0
• Votre syntaxe JSON est valide (attention aux virgules ou guillemets manquants)

La date limite du 31 janvier 2026 approche rapidement, alors assurez-vous de mettre à jour vos workflows bientôt. La migration est simple, et une fois terminée, votre génération automatisée de présentations continuera de fonctionner sans problème avec l’API v1.0 améliorée.