API de test Workflow (mise à jour / publication)

Permet aux développeurs, depuis des outils d'IA comme CodeX, Claude, etc. (ayant installé le GPTBots Agent Skill), d'importer la configuration du fichier .flow générée par les Skills dans un Workflow cible sur la plateforme GPTBots et de la publier en ligne.

⚠️ Seuls les Workflows en « mode test » peuvent être appelés. Un appel en mode officiel retourne 403200. Le mode test est sélectionné lors de la création du Workflow et ne peut pas être modifié après la création.

API de mise à jour du Workflow (importer .flow pour remplacer la version actuelle)

Importe le fichier .flow dans le Workflow cible (mode test) et enregistre la configuration actuelle après remplacement en tant que nouvelle version brouillon (qui devient également la « version actuelle »). Les règles sont les suivantes :

• Bases de connaissances (groupes de données) / tables de base de données / documents de connaissances dans les nœuds : selon la dimension WorkflowID, ceux qui appartiennent toujours au Workflow cible sont conservés, sinon ils sont supprimés ;
• Workflow / outils (plugins) associés : selon la dimension organisation, ceux qui restent valides sont conservés, sinon ils sont supprimés ;
• Identifiants tiers : lors de l'importation dans un Workflow existant, les identifiants déjà configurés sur la cible sont réinjectés selon « **le même ID de nœud / plugin », sans vider les nœuds déjà authentifiés, afin de garantir la disponibilité ;

Méthode de requête

POST

URL de la requête

https://api-${endpoint}.gptbots.ai/v1/workflow/version/import

Requête

Exemple de requête

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/workflow/version/import' \
-H 'Authorization: Bearer {WORKFLOW_API_KEY}' \
-H 'Content-Type: multipart/form-data' \
-F 'file=@my-workflow.flow' \
-F 'versionDesc=Imported by AI tool'

                    

En-têtes de la requête

Paramètres de la requête

Le numéro de version est généré automatiquement par le serveur (dernier segment de la version la plus récente +1 ; en l'absence de version historique, il est 1.0.0).

Réponse

Exemple de réponse

                      
                      {
  "code": 0,
  "msg": "OK",
  "data": {
    "botId": "xxx",
    "botType": "Workflow",
    "version": "1.0.3"
  }
}

                    

Réponse réussie

Réponse en cas d'échec

API de publication du Workflow (publier en ligne par numéro de version)

Publie le numéro de version spécifié du Workflow cible (mode test) en tant que version de production en ligne (cette version devient « en ligne », les autres versions reviennent à l'état brouillon).

Méthode de requête

POST

URL de la requête

https://api-${endpoint}.gptbots.ai/v1/workflow/version/release

Requête

Exemple de requête

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/workflow/version/release' \
-H 'Authorization: Bearer {WORKFLOW_API_KEY}' \
-H 'Content-Type: application/json' \
-d '{
        "version": "1.0.3"
}'

                    

En-têtes de la requête

Paramètres de la requête

Réponse

Exemple de réponse

                      
                      {
  "code": 0,
  "msg": "OK"
}

                    

Réponse réussie

Aucun corps de données ; un code égal à 0 signifie que la publication a réussi.

Réponse en cas d'échec

Codes d'erreur

Les interfaces de mise à jour et de publication partagent le même ensemble de codes d'erreur :