---
title: "Get Stream Events"
method: GET
path: "/v1/workflows/events/stream"
tags: ["events", "workflows.events"]
---

# Get Stream Events

`GET /v1/workflows/events/stream`

Stream workflow events as Server-Sent Events (SSE).

One of `root_workflow_exec_id`, `parent_workflow_exec_id` or `workflow_exec_id` is required.

## Query parameters

- `scope` 'activity' | 'workflow' | '*'
- `activity_name` string
- `activity_id` string
- `workflow_name` string
- `workflow_exec_id` string
- `root_workflow_exec_id` string
- `parent_workflow_exec_id` string
- `stream` string
- `start_seq` integer
- `metadata_filters` object, nullable
- `workflow_event_types` WorkflowEventType[], nullable

## Headers

- `last-event-id` string, nullable

## Response `200`

Stream of Server-Sent Events (SSE)

## Other responses

- `400` — None of `root_workflow_exec_id`, `parent_workflow_exec_id` or `workflow_exec_id` was provided.
- `422` — Validation Error

## Changes

- **2026-09-23** `fa73befe1c61` — 18 info
  - added the non-success response with the status `400`
  - added the required property `data/oneOf[subschema #1: StreamEventSsePayload]/data/oneOf[subschema #10: CustomTaskCompleted]/chain_run_id` to the response with the `200` status
  - added the required property `data/oneOf[subschema #1: StreamEventSsePayload]/data/oneOf[subschema #11: CustomTaskFailed]/chain_run_id` to the response with the `200` status
  - added the required property `data/oneOf[subschema #1: StreamEventSsePayload]/data/oneOf[subschema #12: CustomTaskTimedOut]/chain_run_id` to the response with the `200` status
  - …14 more
- **2026-08-14** `61436a496404` — 55 info
  - added the optional property `data/oneOf[subschema #1: StreamEventSsePayload]/data/oneOf[subschema #1: WorkflowExecutionStarted]/attributes/attempt` to the response with the `200` status
  - added the optional property `data/oneOf[subschema #1: StreamEventSsePayload]/data/oneOf[subschema #2: WorkflowExecutionCompleted]/attributes/attempt` to the response with the `200` status
  - added the optional property `data/oneOf[subschema #1: StreamEventSsePayload]/data/oneOf[subschema #3: WorkflowExecutionFailed]/attributes/attempt` to the response with the `200` status
  - added the optional property `data/oneOf[subschema #1: StreamEventSsePayload]/data/oneOf[subschema #4: WorkflowExecutionCanceled]/attributes/attempt` to the response with the `200` status
  - …51 more

[Change history](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/workflows/events/stream/get.md)

---

[API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.dev/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mistral/apis/mistral-ai-api/revisions/fa73befe1c61?raw)