workflows

---

title: Workflows sidebar_label: Workflows (16) sidebar_position: 2 doc_type: reference

Workflows

En bref

Listez, lancez et suivez vos workflows automatises.

Prerequis

• Cle API avec le preset MCP et les scopes requis
• Client MCP configure (voir Configuration)

Exemples minimaux

Lancer et suivre un workflow

1. Listez les workflows disponibles :

{
  "name": "workflow_list",
  "arguments": {}
}

2. Lancez l'execution :

{
  "name": "workflow_execute",
  "arguments": {
    "workflowId": "uuid-du-workflow"
  }
}

3. Suivez le statut d'execution :

{
  "name": "workflow_status",
  "arguments": {
    "runId": "uuid-de-lexecution"
  }
}

---

workflow_cancel

Annule un workflow en cours d'execution.

Scope	mcp.workflow.execute
Lecture seule	Non
Destructif	Oui
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
runId	string	Oui	The workflow run ID to cancel
reason	string	Non	Optional reason for cancellation

Reponse

Champ	Type	Description
success	boolean
runId	string
workflowId	string
workflowName	string
previousStatus	string
message	string

Outils lies : workflow_status, workflow_execute

---

workflow_create

Cree un nouveau workflow vide ou depuis un template.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
name	string	Oui	Nom du nouveau workflow
canvasId	string (uuid)	Non	Canvas ID to assign the workflow to (uses default canvas if not provided)
description	string	Non	Workflow description

Reponse

Champ	Type	Description
workflowId	string
name	string
description	string
status	string
version	number
canvasId	string
createdAt	string

Outils lies : workflow_update, workflow_execute, workflow_list, workflow_validate

---

workflow_execute

Lance l'execution d'un workflow.

Scope	mcp.workflow.execute
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
async	boolean	Non	Execution asynchrone (true recommande pour les workflows longs) (defaut : true)
inputs	record	Non	Input variables for the workflow
workflowId	string (uuid)	Non	Identifiant unique du workflow a executer
workflowName	string	Non	Workflow name to execute (alternative to workflowId, case-insensitive)

Reponse

Champ	Type	Description
workflow	object
id	string
name	string
wasResolvedByName	boolean
runId	string
taskId	string
streamUrl	string
status	enum
result	unknown

Exemple

{
  "name": "workflow_execute",
  "arguments": {
    "workflowId": "uuid-du-workflow"
  }
}

Outils lies : workflow_status, workflow_cancel, workflow_validate

---

workflow_export

Exporte un workflow au format JSON.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
workflowId	string (uuid)	Oui	ID of the workflow to export
format	choix (json, yaml)	Non	Export format (default: json)
includeTestCases	boolean	Non	Include test cases in export (default: false)

Reponse

Champ	Type	Description
portable	record

Outils lies : workflow_import, workflow_export_bulk

---

workflow_export_bulk

Exporte plusieurs workflows en lot.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
workflowIds	array	Oui	IDs of workflows to export
includeTestCases	boolean	Non	Include test cases in export (default: false)

Reponse

Champ	Type	Description
workflows	array
count	number

Outils lies : workflow_export, workflow_list

---

workflow_get

Recupere la definition complete d'un workflow (blocs, connexions, variables).

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
includeDefinition	boolean	Non	Include full flow definition with blocks and connections (defaut : true)
workflowId	string (uuid)	Non	Identifiant unique du workflow
workflowName	string	Non	Workflow name to retrieve (alternative to workflowId, case-insensitive)

Reponse

Champ	Type	Description
wasResolvedByName	boolean

Outils lies : workflow_list, workflow_validate, workflow_execute

---

workflow_get_block_output

Recupere la sortie d'un bloc specifique dans une execution.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
blockId	string	Oui	The block ID to get output for
runId	string	Oui	The workflow run ID (wfr_xxx format or UUID)
includeInput	boolean	Non	Include the input that was passed to this block (defaut : true)
includeLogs	boolean	Non	Include execution logs for this block (defaut : true)

Reponse

Champ	Type	Description
runId	string
workflowId	string
input	number
output	number
variablesProduced	array
tokens	object
total	number
logs	array

Outils lies : workflow_get_variables, workflow_status

---

workflow_get_variables

Recupere les variables d'execution a un point donne du workflow.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
runId	string	Oui	The workflow run ID (wfr_xxx format or UUID)
blockId	string	Non	Specific block ID to get variables for (returns snapshot before that block)
includeInternal	boolean	Non	Include internal variables (prefixed with __) (defaut : false)

Reponse

Champ	Type	Description
runId	string
workflowId	string
status	string
blockId	string
blockType	string
blockIndex	number
variables	array
availableAt	array
changedVariables	array
timestamp	string

Outils lies : workflow_get_block_output, workflow_status

---

workflow_import

Importe un workflow depuis un fichier JSON.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
workflow	record	Oui	Portable workflow JSON object (from workflow_export)
conflictResolution	choix (fail, update_if_newer, force_update, create_new)	Non	How to handle name conflicts (default: fail)
dryRun	boolean	Non	Validate without persisting (default: false)
preserveId	boolean	Non	Keep original workflow ID (default: false)

Reponse

Champ	Type	Description
success	boolean
workflowId	string
name	string
status	enum
error	string

Outils lies : workflow_export, workflow_list

---

workflow_list

Liste les workflows disponibles dans votre workspace.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
limit	number	Non	Nombre maximum de resultats (defaut : 50)
offset	number	Non	Decalage pour la pagination (defaut : 0)
search	string	Non	Search by name
status	choix (draft, published, archived, all)	Non	Filter by status (defaut : "all")

Reponse

Champ	Type	Description
workflows	array
total	number
hasMore	boolean

Exemple

{
  "name": "workflow_list",
  "arguments": {}
}

Outils lies : workflow_get, workflow_execute, workflow_validate

---

workflow_schedule_create

Cree une planification automatique pour un workflow (cron, intervalle).

Scope	mcp.write, mcp.workflow.execute
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
name	string	Oui	Schedule name
scheduleType	choix (cron, interval, specific)	Oui	Type of schedule
workflowId	string (uuid)	Oui	Workflow ID to schedule
cronExpression	string	Non	Cron expression (for scheduleType=cron). Example: "0 9 * * MON-FRI"
description	string	Non	Schedule description
intervalUnit	choix (seconds, minutes, hours, days, weeks)	Non	Interval unit (for scheduleType=interval)
intervalValue	number	Non	Interval value (for scheduleType=interval)
isEnabled	boolean	Non	Whether schedule is active immediately (defaut : true)
maxConcurrent	number	Non	Max concurrent executions (defaut : 1)
specificTimes	array	Non	Specific times (for scheduleType=specific)
timeoutMs	number	Non	Execution timeout in ms (default: 5 minutes) (defaut : 300000)
timezone	string	Non	Timezone (IANA format). Default: Europe/Paris (defaut : "Europe/Paris")
workflowName	string	Non	Alternative: workflow name (if ID unknown)

Reponse

Champ	Type	Description
scheduleId	string
name	string
workflowId	string
workflowName	string
scheduleType	string
expression	string
timezone	string
isEnabled	boolean
nextRunAt	string
message	string

Outils lies : workflow_schedule_list, workflow_schedule_trigger, workflow_validate

---

workflow_schedule_list

Liste les planifications (schedules) des workflows.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
limit	number	Non	Maximum results (defaut : 50)
offset	number	Non	Pagination offset (defaut : 0)
status	choix (active, paused, all)	Non	Filter by status (defaut : "all")
workflowId	string (uuid)	Non	Filter by workflow ID

Reponse

Champ	Type	Description
schedules	array
total	number
hasMore	boolean

Outils lies : workflow_schedule_create, workflow_schedule_trigger, workflow_list

---

workflow_schedule_trigger

Declenche manuellement une planification existante.

Scope	mcp.workflow.execute
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
scheduleId	string	Oui	Schedule ID to trigger
scheduleName	string	Non	Alternative: schedule name (if ID unknown)

Reponse

Champ	Type	Description
success	boolean
scheduleId	string
scheduleName	string
workflowId	string
workflowName	string
runId	string
triggeredAt	string
message	string

Outils lies : workflow_status, workflow_schedule_list, workflow_execute

---

workflow_status

Consulte le statut d'execution d'un workflow (en cours, termine, echoue).

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
runId	string (uuid)	Oui	Identifiant de l'execution

Reponse

Champ	Type	Description
runId	string
workflowId	string
workflowName	string
status	enum
progress	number
currentNode	string
result	unknown
error	string
startedAt	string
completedAt	string
duration	number

Outils lies : workflow_get_variables, workflow_get_block_output, workflow_cancel

---

workflow_update

Met a jour la definition d'un workflow existant.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
workflowId	string (uuid)	Oui	ID of the workflow to update
description	string	Non	New workflow description
expectedVersion	number	Non	Expected version for OCC conflict detection
name	string	Non	New workflow name
status	choix (draft, published, archived)	Non	New workflow status

Reponse

Champ	Type	Description
workflowId	string
name	string
status	string
version	number
updatedAt	string

Outils lies : workflow_get, workflow_create, workflow_validate

---

workflow_validate

Valide un workflow avant execution (verification des connexions et parametres).

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
checkCycles	boolean	Non	Check for circular dependencies in the flow (defaut : true)
checkReferences	boolean	Non	Validate external references (agents, entities, subflows) (defaut : true)
checkVariables	boolean	Non	Analyze variable usage and detect issues (defaut : true)
workflowId	string (uuid)	Non	Identifiant unique du workflow a valider
workflowName	string	Non	Workflow name to validate (alternative to workflowId)

Reponse

Champ	Type	Description
workflowId	string
workflowName	string
isValid	boolean
canExecute	boolean
summary	object
errorCount	number
warningCount	number
infoCount	number
issues	array
references	array
structure	object
blockCount	number
connectionCount	number
hasTrigger	boolean
hasOutput	boolean
hasCycles	boolean

Outils lies : workflow_execute, workflow_get

---

Depannage

Code	Message	Solution
404	Workflow non trouve	Verifiez l'identifiant avec workflow_list.

Besoin d'aide ?

Ecrivez-nous : Support et contact.