---
title: "Execute Workflow"
method: POST
path: "/v1/workflows/{workflow_identifier}/execute"
tags: ["workflows"]
---

# Execute Workflow

`POST /v1/workflows/{workflow_identifier}/execute`

Execute Workflow

## Path parameters

- `workflow_identifier` string, required

## Request body

- WorkflowExecutionRequest
  - `execution_id` string, nullable — Allows you to specify a custom execution ID. If not provided, a random ID will be generated.
  - `input` union — The input to the workflow. This should be a dictionary or a BaseModel that matches the workflow's input schema.
    - object
    - object
  - `wait_for_result` boolean — If true, wait for the workflow to complete and return the result directly.
  - `timeout_seconds` number, nullable — Maximum time to wait for completion when wait_for_result is true.
  - `custom_tracing_attributes` object, nullable
  - `extensions` object, nullable — Plugin-specific data to propagate into WorkflowContext.extensions at execution time.
  - `task_queue` string, nullable — Deprecated. Use deployment_name instead.
  - `deployment_name` string, nullable — Name of the deployment to route this execution to

## Response `200`

Successful Response

- union
  - WorkflowExecutionResponse
    - `workflow_name` string, required — The name of the workflow
    - `workflow_id` string, uuid, nullable — The ID of the workflow
    - `deployment_name` string, nullable — The name of the deployment that ran this execution
    - `execution_id` string, required — The ID of the workflow execution
    - `parent_execution_id` string, nullable — The parent execution ID of the workflow execution
    - `root_execution_id` string, required — The root execution ID of the workflow execution
    - `run_id` string, nullable — The unique run identifier (database UUID)
    - `user_id` string, nullable — The ID of the user who triggered the execution
    - `status` 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELED' | 'TERMINATED' | 'CONTINUED_AS_NEW' | 'TIMED_OUT' | 'RETRYING_AFTER_ERROR', required
    - `start_time` string, date-time, required — The start time of the workflow execution
    - `end_time` string, date-time, nullable, required — The end time of the workflow execution, if available
    - `total_duration_ms` integer, nullable — The total duration of the trace in milliseconds
    - `result` unknown, required
  - WorkflowExecutionSyncResponse — Response model for synchronous workflow execution
    - `workflow_name` string, required — Name of the workflow that was executed
    - `execution_id` string, required — ID of the workflow execution
    - `result` unknown, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)