---
title: "List workflow execution events"
method: GET
path: "/workflow_executions/{execution_id}/events"
tags: ["Workflows"]
---

# List workflow execution events

`GET /workflow_executions/{execution_id}/events`

Retrieve events for a workflow execution in reverse chronological order (most recent first).

Use `limit`, `after`, and `before` for cursor pagination. Cursors are returned in the `paging` object.

## Query parameters

- `event_type` string
- `limit` integer
- `before` string
- `after` string

## Response `200`

Events retrieved successfully

- WorkflowEventListResponse — List of workflow execution events with cursor pagination metadata
  - `data` WorkflowEvent[], required
    - `id` string, uuid, required — Event identifier
    - `event_type` string, required — Event type indicating what happened in the workflow execution. Common types: - `execution_started`, `execution_ended`, `execution_failed`: Execution lifecycle - `step_entered`, `step_completed`, `step_failed`: Step lifecycle - `decision_evaluating`, `decision_evaluated`: Conditional branching - `action_executing`, `action_performed`, `action_failed`: Action execution - `variables_set`, `variables_merged`: Variable updates - `wait_timeout`, `user_input_received`: Wait step events - `agent_iteration_started`, `agent_tool_called`, `agent_message_sent`: Agent step events
    - `direction` string, nullable — Edge direction/label for transition events (used when moving between steps)
    - `edge_label` string, nullable — Label of the edge taken during decision or transition events
    - `created_at` string, date-time, required — Event timestamp
    - `payload` object — Event-specific data (varies by event_type)
    - `step` WorkflowStepReference — Reference to a workflow step (used in execution current_step tracking)
      - `id` string, uuid, required — Internal ID of the workflow step
      - `identifier` string, required — Step identifier within the workflow (e.g., 'start', 'step1', 'agent_greeting')
      - `stepable_type` string, nullable — Ruby class name of the step type (e.g., 'FlowAgentStep', 'FlowActionStep', 'FlowWaitStep', 'FlowDecideStep')
      - `position` object, nullable — Canvas position for visual editor
        - `x` number
        - `y` number
  - `paging` Paging, required
    - `cursors` PaginationCursor
      - `before` string — Cursor for previous page (Base64 encoded)
      - `after` string — Cursor for next page (Base64 encoded)
    - `next` string, nullable
    - `previous` string, nullable

## Other responses

- `401` — Missing or invalid API key
- `404` — Resource not found

---

[API](https://skmtc.net/kapso/apis/kapso-platform-api.md) · [All operations](https://skmtc.net/kapso/apis/kapso-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kapso/kapso-platform-api/revisions/18ff5548a33f/schema)