Beta Workflows Executions Endpoints

Trigger, monitor, and control workflow executions.

Get Workflow Execution

GET /v1/workflows/executions/{execution_id}

200

Successful Response

end_time

*date-time|null

The end time of the workflow execution, if available

execution_id

*string

The ID of the workflow execution

parent_execution_id

string|null

The parent execution ID of the workflow execution

result

*any|null

The result of the workflow execution, if available

root_execution_id

*string

The root execution ID of the workflow execution

start_time

*date-time

The start time of the workflow execution

status

The status of the workflow execution

total_duration_ms

integer|null

The total duration of the trace in milliseconds

workflow_name

*string

The name of the workflow

Playground

Test the endpoints live

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

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

200

{
  "end_time": null,
  "execution_id": "ipsum eiusmod",
  "result": null,
  "root_execution_id": "consequat do",
  "start_time": "2025-10-07T20:56:01.974Z",
  "status": "RUNNING",
  "workflow_name": "reprehenderit ut dolore"
}

{
  "end_time": null,
  "execution_id": "ipsum eiusmod",
  "result": null,
  "root_execution_id": "consequat do",
  "start_time": "2025-10-07T20:56:01.974Z",
  "status": "RUNNING",
  "workflow_name": "reprehenderit ut dolore"
}

Get Workflow Execution History

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

200

Response Type

any

Successful Response

Playground

Test the endpoints live

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

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

200

null

null

Signal Workflow Execution

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

202

Successful Response

message

string

Default Value: "Signal accepted"

Playground

Test the endpoints live

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": "ipsum eiusmod"
}'

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": "ipsum eiusmod"
}'

202

{}

{}

Query Workflow Execution

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

200

Successful Response

query_name

*string

result

*any

The result of the Query workflow call

Playground

Test the endpoints live

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": "ipsum eiusmod"
}'

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": "ipsum eiusmod"
}'

200

{
  "query_name": "ipsum eiusmod",
  "result": null
}

{
  "query_name": "ipsum eiusmod",
  "result": null
}

Terminate Workflow Execution

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

Playground

Test the endpoints live

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

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

Batch Terminate Workflow Executions

POST /v1/workflows/executions/terminate

200

Successful Response

results

map<BatchExecutionResult>

Mapping of execution_id to result with status and optional error message

Playground

Test the endpoints live

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": [
    "ipsum eiusmod"
  ]
}'

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": [
    "ipsum eiusmod"
  ]
}'

200

{}

{}

Cancel Workflow Execution

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

Playground

Test the endpoints live

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

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

Batch Cancel Workflow Executions

POST /v1/workflows/executions/cancel

200

Successful Response

results

map<BatchExecutionResult>

Mapping of execution_id to result with status and optional error message

Playground

Test the endpoints live

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": [
    "ipsum eiusmod"
  ]
}'

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": [
    "ipsum eiusmod"
  ]
}'

200

{}

{}

Reset Workflow

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

Playground

Test the endpoints live

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
}'

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
}'

Update Workflow Execution

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

200

Successful Response

result

*any

The result of the Update workflow call

update_name

*string

Playground

Test the endpoints live

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": "ipsum eiusmod"
}'

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": "ipsum eiusmod"
}'

200

{
  "result": null,
  "update_name": "ipsum eiusmod"
}

{
  "result": null,
  "update_name": "ipsum eiusmod"
}

Get Workflow Execution Trace Otel

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

200

Successful Response

data_source

*string

The data source of the trace

end_time

*date-time|null

The end time of the workflow execution, if available

execution_id

*string

The ID of the workflow execution

otel_trace_data

TempoGetTraceResponse|null

Trace response in OpenTelemetry format.

This is the unified trace format used across all trace providers (Tempo, ClickHouse, etc.). Regardless of the underlying backend, all trace data is normalized to this Tempo-compatible OpenTelemetry format to ensure consistency in the API response structure.

otel_trace_id

string|null

The ID of the trace

parent_execution_id

string|null

The parent execution ID of the workflow execution

result

*any|null

The result of the workflow execution, if available

root_execution_id

*string

The root execution ID of the workflow execution

start_time

*date-time

The start time of the workflow execution

status

The status of the workflow execution

total_duration_ms

integer|null

The total duration of the trace in milliseconds

workflow_name

*string

The name of the workflow

Playground

Test the endpoints live

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

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

200

{
  "data_source": "ipsum eiusmod",
  "end_time": null,
  "execution_id": "consequat do",
  "result": null,
  "root_execution_id": "reprehenderit ut dolore",
  "start_time": "2025-10-07T20:56:01.974Z",
  "status": "RUNNING",
  "workflow_name": "occaecat dolor sit"
}

{
  "data_source": "ipsum eiusmod",
  "end_time": null,
  "execution_id": "consequat do",
  "result": null,
  "root_execution_id": "reprehenderit ut dolore",
  "start_time": "2025-10-07T20:56:01.974Z",
  "status": "RUNNING",
  "workflow_name": "occaecat dolor sit"
}

Get Workflow Execution Trace Summary

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

200

Successful Response

end_time

*date-time|null

The end time of the workflow execution, if available

execution_id

*string

The ID of the workflow execution

parent_execution_id

string|null

The parent execution ID of the workflow execution

result

*any|null

The result of the workflow execution, if available

root_execution_id

*string

The root execution ID of the workflow execution

span_tree

WorkflowExecutionTraceSummarySpan|null

The root span of the trace

start_time

*date-time

The start time of the workflow execution

status

The status of the workflow execution

total_duration_ms

integer|null

The total duration of the trace in milliseconds

workflow_name

*string

The name of the workflow

Playground

Test the endpoints live

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

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": "ipsum eiusmod",
  "result": null,
  "root_execution_id": "consequat do",
  "start_time": "2025-10-07T20:56:01.974Z",
  "status": "RUNNING",
  "workflow_name": "reprehenderit ut dolore"
}

{
  "end_time": null,
  "execution_id": "ipsum eiusmod",
  "result": null,
  "root_execution_id": "consequat do",
  "start_time": "2025-10-07T20:56:01.974Z",
  "status": "RUNNING",
  "workflow_name": "reprehenderit ut dolore"
}

Get Workflow Execution Trace Events

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

200

Successful Response

end_time

*date-time|null

The end time of the workflow execution, if available

events

array<WorkflowExecutionTraceEvent|WorkflowExecutionProgressTraceEvent>

The events of the workflow execution

execution_id

*string

The ID of the workflow execution

parent_execution_id

string|null

The parent execution ID of the workflow execution

result

*any|null

The result of the workflow execution, if available

root_execution_id

*string

The root execution ID of the workflow execution

start_time

*date-time

The start time of the workflow execution

status

The status of the workflow execution

total_duration_ms

integer|null

The total duration of the trace in milliseconds

workflow_name

*string

The name of the workflow

Playground

Test the endpoints live

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

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": "ipsum eiusmod",
  "result": null,
  "root_execution_id": "consequat do",
  "start_time": "2025-10-07T20:56:01.974Z",
  "status": "RUNNING",
  "workflow_name": "reprehenderit ut dolore"
}

{
  "end_time": null,
  "execution_id": "ipsum eiusmod",
  "result": null,
  "root_execution_id": "consequat do",
  "start_time": "2025-10-07T20:56:01.974Z",
  "status": "RUNNING",
  "workflow_name": "reprehenderit ut dolore"
}

Stream

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

200

Response Type

event-stream<ResponseBody>

Stream of Server-Sent Events (SSE)

ResponseBody

{object}

Playground

Test the endpoints live

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

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

200

null

null

Beta Workflows Executions Endpoints

Examples

GET /v1/workflows/executions/{execution_id}

Parameters

execution_id

end_time

execution_id

parent_execution_id

result

root_execution_id

start_time

status

total_duration_ms

workflow_name

Playground

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

Parameters

execution_id

decode_payloads

Playground

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

Parameters

execution_id

Request Body

input

name

message

Playground

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

Parameters

execution_id

Request Body

input

name

query_name

result

Playground

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

Parameters

execution_id

Playground

POST /v1/workflows/executions/terminate

Request Body

execution_ids

results

Playground

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

Parameters

execution_id

Playground

POST /v1/workflows/executions/cancel

Request Body

execution_ids

results

Playground

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

Parameters

execution_id

Request Body

event_id

exclude_signals

exclude_updates

reason

Playground

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

Parameters

execution_id

Request Body

input

name

result

update_name

Playground

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

Parameters

execution_id

data_source

end_time

execution_id

otel_trace_data