# Fiche connecteur Dify
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## Dify
URL : https://get-bruno.com/features/connectors/dify
Référence texte : https://get-bruno.com/features/connectors/dify/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Intelligence artificielle
Description : Service de workflows agentiques pour exécuter des workflows Dify publiés et consulter l’historique des conversations et des journaux d’exécution.
Authentification : API key
Présentation : Service de workflows agentiques pour exécuter des workflows Dify publiés et consulter l’historique des conversations et des journaux d’exécution.
Usage : Préparer les entrées d’un workflow Dify
Exemple de demande : Je veux lancer le workflow de l’application « compte-rendu client » avec une ville, mais je dois d’abord savoir quels champs d’entrée sont attendus.
Résultat attendu : La configuration de l’application connectée, avec les noms exacts des variables d’entrée, leurs types, les champs obligatoires, les limites de téléversement, le message d’ouverture et les questions suggérées.
À préciser : Le nom ou l’usage de l’application Dify concernée ; Le besoin métier qui motive la préparation des entrées
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/dify/actions/get-app-parameters
Usage : Relire l’historique d’une conversation
Exemple de demande : Je veux retrouver la conversation « suivi commande Atelier Martin » pour relire ses derniers messages.
Résultat attendu : La liste des conversations de l’utilisateur indiqué, puis l’historique des messages de la conversation choisie.
À préciser : L’identifiant ou la valeur d’utilisateur utilisée pour cette conversation ; L’identifiant de la conversation à consulter
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/dify/actions/list-conversations ; https://pipedream.com/apps/dify/actions/list-messages
Usage : Contrôler les exécutions d’un workflow publié
Exemple de demande : Je veux vérifier les derniers runs du workflow « extraction catalogue » pour l’utilisateur user-123.
Résultat attendu : Un résumé des exécutions passées avec leur statut, leur usage de jetons, le nombre d’étapes et les temps d’exécution.
À préciser : Le type d’application doit être un workflow publié ; La valeur utilisateur à filtrer pour retrouver les runs
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/dify/actions/list-workflow-logs
Limites propres au service : L’action Exécuter le workflow ne fonctionne que pour une application de type Workflow publiée. Les conversations sont filtrées par utilisateur. Les journaux de workflow ne couvrent pas les applications de type Chatflow, Chatbot, Agent ou Text Generator. Les journaux renvoient un résumé de run, pas des logs nœud par nœud.
Vocabulaire français : Obtenir les paramètres de l’application — Retourne la configuration de l’application Dify connectée, y compris les variables d’entrée, les champs obligatoires, les limites de téléversement, le message d’ouverture et les questions suggérées. (https://pipedream.com/apps/dify/actions/get-app-parameters)
Vocabulaire français : Lister les conversations — Liste les conversations d’une application Dify, les plus récentes d’abord, pour un utilisateur donné. (https://pipedream.com/apps/dify/actions/list-conversations)
Vocabulaire français : Lister les messages — Retourne l’historique des messages d’une conversation Dify, avec possibilité d’obtenir plus de détails. (https://pipedream.com/apps/dify/actions/list-messages)
Vocabulaire français : Lister les journaux de workflow — Liste les exécutions passées d’une application workflow Dify avec leur statut, leur usage de jetons et leurs temps. (https://pipedream.com/apps/dify/actions/list-workflow-logs)
Vocabulaire français : Exécuter le workflow — Lance le workflow publié de l’application Dify connectée et renvoie ses sorties. (https://pipedream.com/apps/dify/actions/run-workflow)
- action : Get App Parameters — Return the connected Dify app's configuration: its user_input_form (the exact input variable names, types, and which are required), file-upload limits, opening statement, and suggested questions. Call this before Run Workflow to know what to pass in its Inputs parameter, instead of guessing variable names. Example: an app with one required text variable returns { user_input_form: [{ "text-input": { variable: "city", label: "City", required: true, default: "" } }], opening_statement, suggested_questions, file_upload, ... } , so pass { "city": "..." } as Inputs . See the documentation (https://pipedream.com/apps/dify/actions/get-app-parameters)
- action : List Conversations — List a Dify Chatflow, Chatbot, Agent, or Legacy Agent app's conversations, most recently active first. Conversations are scoped by User , so pass the same value used to create those conversations to see that end user's threads. Example: User user-123 , Limit 20 → { data: [{ id, name: "iPhone Specs Chat", inputs, status: "normal", created_at, updated_at }], has_more: true, limit: 20 } . If has_more is true , call again with Last Conversation ID set to the id of the last conversation in data . Pass a conversation's id to List Messages to read it. See the documentation (https://pipedream.com/apps/dify/actions/list-conversations)
- action : List Messages — Return a Dify Chatflow, Chatbot, Agent, or Legacy Agent conversation's message history. The first call returns the latest messages; page backward into older ones with First Message ID . Use List Conversations to find a Conversation ID . Each message includes the query / answer pair, so this is how an agent reconstructs prior turns of a conversation instead of relying on its own memory. By default each message is trimmed to id , conversation_id , query , answer , status , error , feedback , and created_at ; set Include Full Details to also get retrieved knowledge-base passages ( retriever_resources ), agent reasoning ( agent_thoughts ), files, and token usage. Example: Conversation ID 45701982-8118-4bc5-8e9b-64562b4555f2 , User user-123 → { data: [{ id, conversation_id, query: "What are the specs of the iPhone 13 Pro Max?", answer: "...", status: "normal", feedback: { rating: "like" }, created_at }], has_more: true, limit: 20 } . If has_more is true , call again with First Message ID set to the id of the first message in data to get older messages. See the documentation (https://pipedream.com/apps/dify/actions/list-messages)
- action : List Workflow Logs — List past runs of a Dify Workflow app, newest first, with each run's status, token usage, step count, and timing. Only Workflow apps record these logs: a Chatflow, Chatbot, Agent, or Text Generator app's key returns an empty page, not an error. For runs started through the API, created_by_end_user.session_id is the User value sent with that run, which is useful for tracing a run back to its caller and for filtering with User . Runs started by a team member inside Dify have created_by_end_user: null and an account under created_by_account instead. Each entry is a run-level summary; node-by-node execution logs for finished runs aren't available. Example: Status failed , Limit 5 → { data: [{ id, created_by_role: "end_user", created_by_end_user: { id, session_id: "user-123", type: "service-api" }, workflow_run: { id, status: "failed", error, total_tokens, elapsed_time } }], page: 1, limit: 5, total: 12, has_more: true } . If has_more is true , call again with Page incremented by one. See the documentation (https://pipedream.com/apps/dify/actions/list-workflow-logs)
- action : Run Workflow — Run the published workflow of the Dify app that the connected API key belongs to, and return its outputs. Only works for Workflow -type apps: a Chatflow, Chatbot, Agent, or Text Generator app's key returns a not_workflow_app error. Requires the workflow to be published; an unpublished workflow returns an invalid_param error. Use Get App Parameters first to learn the input variable names. Example: Inputs { "city": "San Francisco" } , User user-123 → { workflow_run_id, data: { id, status: "succeeded", outputs: { result: "..." }, total_tokens, elapsed_time } } . This action uses blocking response mode, which waits for the run to finish before returning; long-running workflows on Dify Cloud risk being cut off by the platform's 100-second edge proxy timeout, in which case the run may still complete server-side but this action will not see the result. See the documentation (https://pipedream.com/apps/dify/actions/run-workflow)