La spec OpenAPI
Home
Tree BG 1
Tree
Tree
TreeLeaves
TreeLeaves
Cat IdleGrassGrassRockRock

Exécutions des workflows

Obtenir l'exécution du workflow

GET /v1/workflows/executions/{execution_id}

200

Réponse réussie

end_time
*date-time|null

L'heure de fin de l'exécution du workflow, si disponible

execution_id
*string

L'ID de l'exécution du workflow

parent_execution_id
string|null

L'ID d'exécution parent de l'exécution du workflow

result
*any|null

Le résultat de l'exécution du workflow, si disponible

root_execution_id
*string

L'ID d'exécution racine de l'exécution du workflow

run_id
string|null

L'identifiant unique de l'exécution (UUID de la base de données)

start_time
*date-time

L'heure de début de l'exécution du workflow

status
*"RUNNING"|"COMPLETED"|"FAILED"|"CANCELED"|"TERMINATED"|"CONTINUED_AS_NEW"|"TIMED_OUT"|"RETRYING_AFTER_ERROR"

Le statut de l'exécution du workflow

total_duration_ms
integer|null

La durée totale de la trace en millisecondes

workflow_name
*string

Nom du workflow

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id} \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "end_time": null,
  "execution_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "result": null,
  "root_execution_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "start_time": "2025-12-17T10:25:07.818693Z",
  "status": "RUNNING",
  "workflow_name": "support-workflow"
}

Obtenir l'historique de l'exécution du workflow

GET /v1/workflows/executions/{execution_id}/history

200

Response Type
any

Réponse réussie

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id}/history \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

null

Envoyer un signal à l'exécution du workflow

POST /v1/workflows/executions/{execution_id}/signals

202

Réponse réussie

message
string

Default Value: "Signal accepted"

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id}/signals \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "name": "approve"
}'

202

{}

Interroger l'exécution du workflow

POST /v1/workflows/executions/{execution_id}/queries

200

Réponse réussie

query_name
*string
result
*any

Le résultat de l'appel du workflow de requête

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id}/queries \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "name": "get_progress"
}'

200

{
  "query_name": "status",
  "result": null
}

Terminer l'exécution du workflow

POST /v1/workflows/executions/{execution_id}/terminate

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id}/terminate \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

Terminer les exécutions de workflow en lot

POST /v1/workflows/executions/terminate

200

Réponse réussie

results
map<BatchExecutionResult>

Mappage de execution_id vers le résultat avec le statut et un message d'erreur optionnel.

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/terminate \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "execution_ids": [
    "approved"
  ]
}'

200

{}

Annuler l'exécution du workflow

POST /v1/workflows/executions/{execution_id}/cancel

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id}/cancel \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

Annulation par lot des exécutions de Workflow

POST /v1/workflows/executions/cancel

200

Réponse réussie

results
map<BatchExecutionResult>

Mappage de execution_id vers le résultat avec le statut et un message d'erreur optionnel.

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/cancel \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "execution_ids": [
    "approved"
  ]
}'

200

{}

Réinitialiser le workflow

POST /v1/workflows/executions/{execution_id}/reset

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id}/reset \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "event_id": 87
}'

Mettre à jour l'exécution du workflow

POST /v1/workflows/executions/{execution_id}/updates

200

Réponse réussie

result
*any

Le résultat de l'appel du workflow de mise à jour

update_name
*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id}/updates \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "name": "status_update"
}'

200

{
  "result": null,
  "update_name": "status_update"
}

Obtenir la trace OpenTelemetry de l'exécution du workflow

GET /v1/workflows/executions/{execution_id}/trace/otel

200

Réponse réussie

data_source
*string

La source de données de la trace

end_time
*date-time|null

L'heure de fin de l'exécution du workflow, si disponible

execution_id
*string

L'ID de l'exécution du workflow

otel_trace_data
TempoGetTraceResponse|null

Réponse de trace au format OpenTelemetry.

Il s'agit du format de trace unifié utilisé par tous les fournisseurs de traces (Tempo, ClickHouse, etc.). Quel que soit le backend sous-jacent, toutes les données de trace sont normalisées vers ce format OpenTelemetry compatible avec Tempo afin de garantir la cohérence de la structure de réponse de l'API.

otel_trace_id
string|null

L'ID de la trace

parent_execution_id
string|null

L'ID d'exécution parent de l'exécution du workflow

result
*any|null

Le résultat de l'exécution du workflow, si disponible

root_execution_id
*string

L'ID d'exécution racine de l'exécution du workflow

run_id
string|null

L'identifiant unique de l'exécution (UUID de la base de données)

start_time
*date-time

L'heure de début de l'exécution du workflow

status
*"RUNNING"|"COMPLETED"|"FAILED"|"CANCELED"|"TERMINATED"|"CONTINUED_AS_NEW"|"TIMED_OUT"|"RETRYING_AFTER_ERROR"

Le statut de l'exécution du workflow

total_duration_ms
integer|null

La durée totale de la trace en millisecondes

workflow_name
*string

Nom du workflow

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id}/trace/otel \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "data_source": "workflow-trace",
  "end_time": null,
  "execution_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "result": null,
  "root_execution_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "start_time": "2025-12-17T10:25:07.818693Z",
  "status": "RUNNING",
  "workflow_name": "support-workflow"
}

Obtenir le résumé de la trace de l'exécution du workflow

GET /v1/workflows/executions/{execution_id}/trace/summary

200

Réponse réussie

end_time
*date-time|null

L'heure de fin de l'exécution du workflow, si disponible

execution_id
*string

L'ID de l'exécution du workflow

parent_execution_id
string|null

L'ID d'exécution parent de l'exécution du workflow

result
*any|null

Le résultat de l'exécution du workflow, si disponible

root_execution_id
*string

L'ID d'exécution racine de l'exécution du workflow

run_id
string|null

L'identifiant unique de l'exécution (UUID de la base de données)

span_tree
WorkflowExecutionTraceSummarySpan|null

La span racine de la trace

start_time
*date-time

L'heure de début de l'exécution du workflow

status
*"RUNNING"|"COMPLETED"|"FAILED"|"CANCELED"|"TERMINATED"|"CONTINUED_AS_NEW"|"TIMED_OUT"|"RETRYING_AFTER_ERROR"

Le statut de l'exécution du workflow

total_duration_ms
integer|null

La durée totale de la trace en millisecondes

workflow_name
*string

Nom du workflow

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id}/trace/summary \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "end_time": null,
  "execution_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "result": null,
  "root_execution_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "start_time": "2025-12-17T10:25:07.818693Z",
  "status": "RUNNING",
  "workflow_name": "support-workflow"
}

Obtenir les événements de trace de l'exécution du workflow

GET /v1/workflows/executions/{execution_id}/trace/events

200

Réponse réussie

end_time
*date-time|null

L'heure de fin de l'exécution du workflow, si disponible

events
array<WorkflowExecutionTraceEvent|WorkflowExecutionProgressTraceEvent>

Les événements de l'exécution du workflow

execution_id
*string

L'ID de l'exécution du workflow

parent_execution_id
string|null

L'ID d'exécution parent de l'exécution du workflow

result
*any|null

Le résultat de l'exécution du workflow, si disponible

root_execution_id
*string

L'ID d'exécution racine de l'exécution du workflow

run_id
string|null

L'identifiant unique de l'exécution (UUID de la base de données)

start_time
*date-time

L'heure de début de l'exécution du workflow

status
*"RUNNING"|"COMPLETED"|"FAILED"|"CANCELED"|"TERMINATED"|"CONTINUED_AS_NEW"|"TIMED_OUT"|"RETRYING_AFTER_ERROR"

Le statut de l'exécution du workflow

total_duration_ms
integer|null

La durée totale de la trace en millisecondes

workflow_name
*string

Nom du workflow

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id}/trace/events \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "end_time": null,
  "execution_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "result": null,
  "root_execution_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "start_time": "2025-12-17T10:25:07.818693Z",
  "status": "RUNNING",
  "workflow_name": "support-workflow"
}

Flux

GET /v1/workflows/executions/{execution_id}/stream

200

Response Type
event-stream<ResponseBody>

Flux d'événements serveur (SSE)

ResponseBody

{object}

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id}/stream \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

null

Obtenir les journaux d'exécution de workflow

GET /v1/workflows/executions/{execution_id}/logs

Récupérer les journaux d'une exécution de workflow depuis Dora.

La première page définit la fenêtre via after/before (par défaut : du début de l'exécution jusqu'à maintenant, les deux élargis par une marge afin que les limites élaguent toujours les partitions) ; les pages suivantes passent cursor, qui contient à la fois la fenêtre et l'ordre de tri (ainsi after/before/order sont alors ignorés — l'ordre est fixé à la première page afin qu'un client ne puisse pas inverser la direction en cours de pagination).

200

Réponse réussie

next_cursor
string|null
results
*array<ExecutionLogRecord>

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id}/logs \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "results": [
    {
      "body": "ipsum eiusmod",
      "log_attributes": [
        "consequat do"
      ],
      "severity_text": "reprehenderit ut dolore",
      "span_id": "occaecat dolor sit",
      "timestamp": "2025-12-17T10:25:07.818693Z",
      "trace_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
    }
  ]
}

Diffuser les journaux d'exécution de workflow

GET /v1/workflows/executions/{execution_id}/logs/stream

Diffuser les journaux d'une exécution de workflow via SSE.

Si last_event_id est défini, la diffusion reprend à partir de ce curseur et prend le pas sur after; sinon, after définit le point de départ d'une nouvelle diffusion (omettre les deux pour suivre à partir du début de l'exécution).

200

Response Type
event-stream<ResponseBody>

Flux d'événements Server-Sent Events (SSE) : les événements log contiennent un ExecutionLogRecord ; les événements error contiennent une charge utile StreamError.

ResponseBody

{object}

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/workflows/executions/{execution_id}/logs/stream \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

null