Workflow Runs
List Workflow Logs
Available for: Chatflow, Workflow apps.
List past workflow runs with optional filters. Each entry is a run-level summary (status, token usage, step count, and timing), not a node-by-node execution log.
To follow a run's node-level events, stream it instead:
- A run you start: use Run Workflow in streaming mode, which emits node_started and node_finished as the run executes.
- A run already in progress: call Stream Workflow Events with include_state_snapshot=true to replay each executed node's status, then stream the rest.
A finished run's node-level logs aren't available through the Service API.
get/workflows/logs
Query parameters
keywordstring
Keyword to search in logs.
status'succeeded' | 'failed' | 'stopped'
Filter by execution status.
pageinteger
Page number.
limitinteger
Number of items per page.
created_at__beforestring date-time
Filter logs created before this ISO 8601 timestamp.
created_at__afterstring date-time
Filter logs created after this ISO 8601 timestamp.
created_by_end_user_session_idstring
Filter by end user session ID.
created_by_accountstring
Filter by the creator's account email (e.g., name@example.com).
Response
Successfully retrieved workflow logs.