--- title: "Get Workflow Events" method: GET path: "/v1/workflows/events/list" tags: ["events", "workflows.events"] --- # Get Workflow Events `GET /v1/workflows/events/list` Get Workflow Events ## Query parameters - `root_workflow_exec_id` string, nullable — Execution ID of the root workflow that initiated this execution chain. - `workflow_exec_id` string, nullable — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, nullable — Run ID of the workflow that emitted this event. - `limit` integer — Maximum number of events to return. - `cursor` string, nullable — Cursor for pagination. ## Response `200` Successful Response - ListWorkflowEventResponse - `events` union[], required — List of workflow events. - union - WorkflowExecutionStartedResponse — Emitted when a workflow execution begins. This is the first event in any workflow execution lifecycle. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'WORKFLOW_EXECUTION_STARTED', required — Event type discriminator. - `attributes` WorkflowExecutionStartedAttributesResponse, required — Attributes for workflow execution started events. - `task_id` string, required — Unique identifier for the task within the workflow execution. - `workflow_name` string, required — The registered name of the workflow being executed. - `display_name` string, nullable — The user-friendly display name of the workflow, if available. - `input` JSONPayloadResponse, required — A payload containing arbitrary JSON data. Used for complete state snapshots or final results. When encrypted, the value field contains base64-encoded encrypted data and encoding_options indicates the type of encryption applied. - `type` 'json', required — Discriminator indicating this is a raw JSON payload. - `value` unknown, required - `encoding_options` EncodedPayloadOptions[], nullable — Encoding options applied to the payload. - WorkflowExecutionCompletedResponse — Emitted when a workflow execution completes successfully. This is a terminal event indicating the workflow finished without errors. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'WORKFLOW_EXECUTION_COMPLETED', required — Event type discriminator. - `attributes` WorkflowExecutionCompletedAttributesResponse, required — Attributes for workflow execution completed events. - `task_id` string, required — Unique identifier for the task within the workflow execution. - `result` JSONPayloadResponse, required — A payload containing arbitrary JSON data. Used for complete state snapshots or final results. When encrypted, the value field contains base64-encoded encrypted data and encoding_options indicates the type of encryption applied. - `type` 'json', required — Discriminator indicating this is a raw JSON payload. - `value` unknown, required - `encoding_options` EncodedPayloadOptions[], nullable — Encoding options applied to the payload. - WorkflowExecutionFailedResponse — Emitted when a workflow execution fails due to an unhandled exception. This is a terminal event indicating the workflow ended with an error. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'WORKFLOW_EXECUTION_FAILED', required — Event type discriminator. - `attributes` WorkflowExecutionFailedAttributes, required — Attributes for workflow execution failed events. - `task_id` string, required — Unique identifier for the task within the workflow execution. - `failure` Failure, required — Represents an error or exception that occurred during execution. - `message` string, required — A human-readable description of the failure. - WorkflowExecutionCanceledResponse — Emitted when a workflow execution is canceled. This is a terminal event indicating the workflow was explicitly canceled. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'WORKFLOW_EXECUTION_CANCELED', required — Event type discriminator. - `attributes` WorkflowExecutionCanceledAttributes, required — Attributes for workflow execution canceled events. - `task_id` string, required — Unique identifier for the task within the workflow execution. - `reason` string, nullable — Optional reason provided for the cancellation. - WorkflowExecutionContinuedAsNewResponse — Emitted when a workflow continues as a new execution. This occurs when a workflow uses continue-as-new to reset its history while maintaining logical continuity. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'WORKFLOW_EXECUTION_CONTINUED_AS_NEW', required — Event type discriminator. - `attributes` WorkflowExecutionContinuedAsNewAttributesResponse, required — Attributes for workflow execution continued-as-new events. - `task_id` string, required — Unique identifier for the task within the workflow execution. - `new_execution_run_id` string, required — The run ID of the new workflow execution that continues this workflow. - `workflow_name` string, required — The registered name of the continued workflow. - `input` JSONPayloadResponse, required — A payload containing arbitrary JSON data. Used for complete state snapshots or final results. When encrypted, the value field contains base64-encoded encrypted data and encoding_options indicates the type of encryption applied. - `type` 'json', required — Discriminator indicating this is a raw JSON payload. - `value` unknown, required - `encoding_options` EncodedPayloadOptions[], nullable — Encoding options applied to the payload. - WorkflowTaskTimedOutResponse — Emitted when a workflow task times out. This indicates the workflow task (a unit of workflow execution) exceeded its configured timeout. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'WORKFLOW_TASK_TIMED_OUT', required — Event type discriminator. - `attributes` WorkflowTaskTimedOutAttributes, required — Attributes for workflow task timed out events. - `task_id` string, required — Unique identifier for the task within the workflow execution. - `timeout_type` string, nullable — The type of timeout that occurred (e.g., 'START_TO_CLOSE', 'SCHEDULE_TO_START'). - WorkflowTaskFailedResponse — Emitted when a workflow task fails. This indicates an error occurred during workflow task execution, which may trigger a retry depending on configuration. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'WORKFLOW_TASK_FAILED', required — Event type discriminator. - `attributes` WorkflowTaskFailedAttributes, required — Attributes for workflow task failed events. - `task_id` string, required — Unique identifier for the task within the workflow execution. - `failure` Failure, required — Represents an error or exception that occurred during execution. - `message` string, required — A human-readable description of the failure. - CustomTaskStartedResponse — Emitted when a custom task begins execution. Custom tasks represent user-defined units of work within a workflow, such as LLM calls, API requests, or data processing steps. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'CUSTOM_TASK_STARTED', required — Event type discriminator. - `attributes` CustomTaskStartedAttributesResponse, required — Attributes for custom task started events. - `custom_task_id` string, required — Unique identifier for the custom task within the workflow. - `custom_task_type` string, required — The type/category of the custom task (e.g., 'llm_call', 'api_request'). - `payload` JSONPayloadResponse — A payload containing arbitrary JSON data. Used for complete state snapshots or final results. When encrypted, the value field contains base64-encoded encrypted data and encoding_options indicates the type of encryption applied. - `type` 'json', required — Discriminator indicating this is a raw JSON payload. - `value` unknown, required - `encoding_options` EncodedPayloadOptions[], nullable — Encoding options applied to the payload. - CustomTaskInProgressResponse — Emitted during custom task execution to report progress. This event supports streaming updates via JSON or JSON Patch payloads, enabling real-time progress tracking for long-running tasks. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'CUSTOM_TASK_IN_PROGRESS', required — Event type discriminator. - `attributes` CustomTaskInProgressAttributesResponse, required — Attributes for custom task in-progress events with streaming updates. - `custom_task_id` string, required — Unique identifier for the custom task within the workflow. - `custom_task_type` string, required — The type/category of the custom task (e.g., 'llm_call', 'api_request'). - `payload` union, required — The current state or incremental update for the task. - JSONPayloadResponse — A payload containing arbitrary JSON data. Used for complete state snapshots or final results. When encrypted, the value field contains base64-encoded encrypted data and encoding_options indicates the type of encryption applied. - … - JSONPatchPayloadResponse — A payload containing a list of JSON Patch operations. Used for streaming incremental updates to workflow state. When encrypted, the value field contains base64-encoded encrypted data and encoding_options indicates the type of encryption applied. - … - CustomTaskCompletedResponse — Emitted when a custom task completes successfully. Contains the final result of the task execution. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'CUSTOM_TASK_COMPLETED', required — Event type discriminator. - `attributes` CustomTaskCompletedAttributesResponse, required — Attributes for custom task completed events. - `custom_task_id` string, required — Unique identifier for the custom task within the workflow. - `custom_task_type` string, required — The type/category of the custom task (e.g., 'llm_call', 'api_request'). - `payload` JSONPayloadResponse, required — A payload containing arbitrary JSON data. Used for complete state snapshots or final results. When encrypted, the value field contains base64-encoded encrypted data and encoding_options indicates the type of encryption applied. - `type` 'json', required — Discriminator indicating this is a raw JSON payload. - `value` unknown, required - `encoding_options` EncodedPayloadOptions[], nullable — Encoding options applied to the payload. - CustomTaskFailedResponse — Emitted when a custom task fails. Contains details about the failure for debugging and error handling. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'CUSTOM_TASK_FAILED', required — Event type discriminator. - `attributes` CustomTaskFailedAttributes, required — Attributes for custom task failed events. - `custom_task_id` string, required — Unique identifier for the custom task within the workflow. - `custom_task_type` string, required — The type/category of the custom task (e.g., 'llm_call', 'api_request'). - `failure` Failure, required — Represents an error or exception that occurred during execution. - `message` string, required — A human-readable description of the failure. - CustomTaskTimedOutResponse — Emitted when a custom task exceeds its timeout. Indicates the task did not complete within its configured time limit. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'CUSTOM_TASK_TIMED_OUT', required — Event type discriminator. - `attributes` CustomTaskTimedOutAttributes, required — Attributes for custom task timed out events. - `custom_task_id` string, required — Unique identifier for the custom task within the workflow. - `custom_task_type` string, required — The type/category of the custom task (e.g., 'llm_call', 'api_request'). - `timeout_type` string, nullable — The type of timeout that occurred. - CustomTaskCanceledResponse — Emitted when a custom task is canceled. Indicates the task was explicitly stopped before completion. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'CUSTOM_TASK_CANCELED', required — Event type discriminator. - `attributes` CustomTaskCanceledAttributes, required — Attributes for custom task canceled events. - `custom_task_id` string, required — Unique identifier for the custom task within the workflow. - `custom_task_type` string, required — The type/category of the custom task (e.g., 'llm_call', 'api_request'). - `reason` string, nullable — Optional reason provided for the cancellation. - ActivityTaskStartedResponse — Emitted when an activity task begins execution. This is the first event for an activity, emitted on the first attempt only. Subsequent retry attempts emit ACTIVITY_TASK_RETRYING instead. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'ACTIVITY_TASK_STARTED', required — Event type discriminator. - `attributes` ActivityTaskStartedAttributesResponse, required — Attributes for activity task started events. - `task_id` string, required — Unique identifier for the activity task within the workflow. - `activity_name` string, required — The registered name of the activity being executed. - `input` JSONPayloadResponse, required — A payload containing arbitrary JSON data. Used for complete state snapshots or final results. When encrypted, the value field contains base64-encoded encrypted data and encoding_options indicates the type of encryption applied. - `type` 'json', required — Discriminator indicating this is a raw JSON payload. - `value` unknown, required - `encoding_options` EncodedPayloadOptions[], nullable — Encoding options applied to the payload. - ActivityTaskCompletedResponse — Emitted when an activity task completes successfully. Contains timing information about the successful execution. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'ACTIVITY_TASK_COMPLETED', required — Event type discriminator. - `attributes` ActivityTaskCompletedAttributesResponse, required — Attributes for activity task completed events. - `task_id` string, required — Unique identifier for the activity task within the workflow. - `activity_name` string, required — The registered name of the activity being executed. - `result` JSONPayloadResponse, required — A payload containing arbitrary JSON data. Used for complete state snapshots or final results. When encrypted, the value field contains base64-encoded encrypted data and encoding_options indicates the type of encryption applied. - `type` 'json', required — Discriminator indicating this is a raw JSON payload. - `value` unknown, required - `encoding_options` EncodedPayloadOptions[], nullable — Encoding options applied to the payload. - ActivityTaskRetryingResponse — Emitted when an activity task fails and will be retried. Contains information about the failed attempt and the error that occurred. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'ACTIVITY_TASK_RETRYING', required — Event type discriminator. - `attributes` ActivityTaskRetryingAttributes, required — Attributes for activity task retrying events. - `task_id` string, required — Unique identifier for the activity task within the workflow. - `activity_name` string, required — The registered name of the activity being executed. - `attempt` integer, required — The attempt number that failed (1-indexed). - `failure` Failure, required — Represents an error or exception that occurred during execution. - `message` string, required — A human-readable description of the failure. - ActivityTaskFailedResponse — Emitted when an activity task fails after exhausting all retry attempts. This is a terminal event indicating the activity could not complete successfully. - `event_id` string, required — Unique identifier for this event instance. - `event_timestamp` integer, required — Unix timestamp in nanoseconds when the event was created. - `root_workflow_exec_id` string, required — Execution ID of the root workflow that initiated this execution chain. - `parent_workflow_exec_id` string, nullable, required — Execution ID of the parent workflow that initiated this execution. If this is a root workflow, this field is not set. - `workflow_exec_id` string, required — Execution ID of the workflow that emitted this event. - `workflow_run_id` string, required — Run ID of the workflow execution. Changes on continue-as-new while workflow_exec_id stays the same. - `workflow_name` string, required — The registered name of the workflow that emitted this event. - `event_type` 'ACTIVITY_TASK_FAILED', required — Event type discriminator. - `attributes` ActivityTaskFailedAttributes, required — Attributes for activity task failed events (final failure after all retries). - `task_id` string, required — Unique identifier for the activity task within the workflow. - `activity_name` string, required — The registered name of the activity being executed. - `attempt` integer, required — The final attempt number that failed (1-indexed). - `failure` Failure, required — Represents an error or exception that occurred during execution. - `message` string, required — A human-readable description of the failure. - `next_cursor` string, nullable — Cursor for pagination. ## 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)