Workflows

June 23, 2026 · View on GitHub

Overview

Available Operations

get_workflows - Get Workflows
get_workflow_registrations - Get Workflow Registrations
execute_workflow - Execute Workflow
~~execute_workflow_registration~~ - Execute Workflow Registration :warning: Deprecated
get_workflow - Get Workflow
update_workflow - Update Workflow
get_workflow_registration - Get Workflow Registration
bulk_archive_workflows - Bulk Archive Workflows
bulk_unarchive_workflows - Bulk Unarchive Workflows
archive_workflow - Archive Workflow
unarchive_workflow - Unarchive Workflow

get_workflows

Get Workflows

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.workflows.get_workflows(include_shared=True, order="asc", limit=50, active_only=False)

    while res is not None:
        # Handle items

        res = res.next()

Parameters

Parameter	Type	Required	Description
`status`	OptionalNullable[models.GetWorkflowsV1WorkflowsGetStatus]	:heavy_minus_sign:	Filter by workflow status
`include_shared`	Optional[bool]	:heavy_minus_sign:	Whether to include shared workflows
`available_in_chat_assistant`	OptionalNullable[bool]	:heavy_minus_sign:	Whether to only return workflows available in chat assistant
`deployment_name`	List[str]	:heavy_minus_sign:	Filter by deployment name(s)
`deployment_status`	OptionalNullable[models.DeploymentStatus]	:heavy_minus_sign:	Filter by deployment activity. active=only active, inactive=only inactive, None=no filter
`archived`	OptionalNullable[bool]	:heavy_minus_sign:	Filter by archived state. False=exclude archived, True=only archived, None=include all
`tags`	List[str]	:heavy_minus_sign:	Filter to workflows tagged with all listed tags (AND).
`order`	Optional[models.GetWorkflowsV1WorkflowsGetOrder]	:heavy_minus_sign:	Sort direction
`cursor`	OptionalNullable[str]	:heavy_minus_sign:	The cursor for pagination
`limit`	Optional[int]	:heavy_minus_sign:	The maximum number of workflows to return
`active_only`	Optional[bool]	:heavy_minus_sign:	: warning: DEPRECATED : This will be removed in a future release, please migrate away from it as soon as possible. Deprecated: use deployment_status instead
`search`	OptionalNullable[str]	:heavy_minus_sign:	Fuzzy search query for workflow name, display name, description, or ID
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.GetWorkflowsV1WorkflowsGetResponse

Errors

Error Type	Status Code	Content Type
errors.HTTPValidationError	422	application/json
errors.SDKError	4XX, 5XX	/

get_workflow_registrations

Get Workflow Registrations

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.workflows.get_workflow_registrations(active_only=False, include_shared=True, with_workflow=False, limit=50)

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`workflow_id`	OptionalNullable[str]	:heavy_minus_sign:	The workflow ID to filter by
`task_queue`	OptionalNullable[str]	:heavy_minus_sign:	The task queue to filter by
`active_only`	Optional[bool]	:heavy_minus_sign:	Whether to only return active workflows versions
`include_shared`	Optional[bool]	:heavy_minus_sign:	Whether to include shared workflow versions
`workflow_search`	OptionalNullable[str]	:heavy_minus_sign:	The workflow name to filter by
`archived`	OptionalNullable[bool]	:heavy_minus_sign:	Filter by archived state. False=exclude archived, True=only archived, None=include all
`with_workflow`	Optional[bool]	:heavy_minus_sign:	Whether to include the workflow definition
`available_in_chat_assistant`	OptionalNullable[bool]	:heavy_minus_sign:	Whether to only return workflows available in chat assistant
`limit`	Optional[int]	:heavy_minus_sign:	The maximum number of workflows versions to return
`cursor`	OptionalNullable[str]	:heavy_minus_sign:	The cursor for pagination
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.WorkflowRegistrationListResponse

Errors

Error Type	Status Code	Content Type
errors.HTTPValidationError	422	application/json
errors.SDKError	4XX, 5XX	/

execute_workflow

Execute Workflow

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.workflows.execute_workflow(workflow_identifier="<value>", wait_for_result=False)

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`workflow_identifier`	str	:heavy_check_mark:	N/A
`execution_id`	OptionalNullable[str]	:heavy_minus_sign:	Allows you to specify a custom execution ID. If not provided, a random ID will be generated.
`input`	OptionalNullable[Any]	:heavy_minus_sign:	The input to the workflow. This should be a dictionary or a BaseModel that matches the workflow's input schema.
`wait_for_result`	Optional[bool]	:heavy_minus_sign:	If true, wait for the workflow to complete and return the result directly.
`timeout_seconds`	OptionalNullable[float]	:heavy_minus_sign:	Maximum time to wait for completion when wait_for_result is true.
`custom_tracing_attributes`	Dict[str, str]	:heavy_minus_sign:	N/A
`extensions`	Dict[str, Any]	:heavy_minus_sign:	Plugin-specific data to propagate into WorkflowContext.extensions at execution time.
`task_queue`	OptionalNullable[str]	:heavy_minus_sign:	: warning: DEPRECATED : This will be removed in a future release, please migrate away from it as soon as possible. Deprecated. Use deployment_name instead.
`deployment_name`	OptionalNullable[str]	:heavy_minus_sign:	Name of the deployment to route this execution to
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.ResponseExecuteWorkflowV1WorkflowsWorkflowIdentifierExecutePost

Errors

Error Type	Status Code	Content Type
errors.HTTPValidationError	422	application/json
errors.SDKError	4XX, 5XX	/

execute_workflow_registration

Execute Workflow Registration

:warning: DEPRECATED: This will be removed in a future release, please migrate away from it as soon as possible.

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.workflows.execute_workflow_registration(workflow_registration_id="de11d76a-e0fb-44dd-abd9-2e75fc275b94", wait_for_result=False)

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`workflow_registration_id`	str	:heavy_check_mark:	N/A
`execution_id`	OptionalNullable[str]	:heavy_minus_sign:	Allows you to specify a custom execution ID. If not provided, a random ID will be generated.
`input`	OptionalNullable[Any]	:heavy_minus_sign:	The input to the workflow. This should be a dictionary or a BaseModel that matches the workflow's input schema.
`wait_for_result`	Optional[bool]	:heavy_minus_sign:	If true, wait for the workflow to complete and return the result directly.
`timeout_seconds`	OptionalNullable[float]	:heavy_minus_sign:	Maximum time to wait for completion when wait_for_result is true.
`custom_tracing_attributes`	Dict[str, str]	:heavy_minus_sign:	N/A
`extensions`	Dict[str, Any]	:heavy_minus_sign:	Plugin-specific data to propagate into WorkflowContext.extensions at execution time.
`task_queue`	OptionalNullable[str]	:heavy_minus_sign:	: warning: DEPRECATED : This will be removed in a future release, please migrate away from it as soon as possible. Deprecated. Use deployment_name instead.
`deployment_name`	OptionalNullable[str]	:heavy_minus_sign:	Name of the deployment to route this execution to
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.ResponseExecuteWorkflowRegistrationV1WorkflowsRegistrationsWorkflowRegistrationIDExecutePost

Errors

Error Type	Status Code	Content Type
errors.HTTPValidationError	422	application/json
errors.SDKError	4XX, 5XX	/

get_workflow

Get Workflow

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.workflows.get_workflow(workflow_identifier="<value>")

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`workflow_identifier`	str	:heavy_check_mark:	N/A
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.WorkflowGetResponse

Errors

Error Type	Status Code	Content Type
errors.HTTPValidationError	422	application/json
errors.SDKError	4XX, 5XX	/

update_workflow

Update Workflow

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.workflows.update_workflow(workflow_identifier="<value>")

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`workflow_identifier`	str	:heavy_check_mark:	N/A
`display_name`	OptionalNullable[str]	:heavy_minus_sign:	New display name value
`description`	OptionalNullable[str]	:heavy_minus_sign:	New description value
`available_in_chat_assistant`	OptionalNullable[bool]	:heavy_minus_sign:	Whether to make the workflow available in the chat assistant
`tags`	List[str]	:heavy_minus_sign:	New tags. Replaces the existing tag list.
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.WorkflowUpdateResponse

Errors

Error Type	Status Code	Content Type
errors.HTTPValidationError	422	application/json
errors.SDKError	4XX, 5XX	/

get_workflow_registration

Get Workflow Registration

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.workflows.get_workflow_registration(workflow_registration_id="c4d86c40-960f-4e9a-9d6f-ad8342d7aa83", with_workflow=False, include_shared=True)

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`workflow_registration_id`	str	:heavy_check_mark:	N/A
`with_workflow`	Optional[bool]	:heavy_minus_sign:	Whether to include the workflow definition
`include_shared`	Optional[bool]	:heavy_minus_sign:	Whether to include shared workflow versions
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.WorkflowRegistrationGetResponse

Errors

Error Type	Status Code	Content Type
errors.HTTPValidationError	422	application/json
errors.SDKError	4XX, 5XX	/

bulk_archive_workflows

Bulk Archive Workflows

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.workflows.bulk_archive_workflows(workflow_ids=[])

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`workflow_ids`	List[str]	:heavy_check_mark:	List of workflow IDs to archive
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.WorkflowBulkArchiveResponse

Errors

Error Type	Status Code	Content Type
errors.HTTPValidationError	422	application/json
errors.SDKError	4XX, 5XX	/

bulk_unarchive_workflows

Bulk Unarchive Workflows

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.workflows.bulk_unarchive_workflows(workflow_ids=[])

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`workflow_ids`	List[str]	:heavy_check_mark:	List of workflow IDs to unarchive
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.WorkflowBulkUnarchiveResponse

Errors

Error Type	Status Code	Content Type
errors.HTTPValidationError	422	application/json
errors.SDKError	4XX, 5XX	/

archive_workflow

Archive Workflow

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.workflows.archive_workflow(workflow_identifier="<value>")

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`workflow_identifier`	str	:heavy_check_mark:	N/A
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.WorkflowArchiveResponse

Errors

Error Type	Status Code	Content Type
errors.HTTPValidationError	422	application/json
errors.SDKError	4XX, 5XX	/

unarchive_workflow

Unarchive Workflow

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.workflows.unarchive_workflow(workflow_identifier="<value>")

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`workflow_identifier`	str	:heavy_check_mark:	N/A
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.WorkflowUnarchiveResponse

Errors

Error Type	Status Code	Content Type
errors.HTTPValidationError	422	application/json
errors.SDKError	4XX, 5XX	/