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_startedandnode_finishedas the run executes. - A run already in progress: call Stream Workflow Events with
include_state_snapshot=trueto replay each executed node’s status, then stream the rest.
A finished run’s node-level logs aren’t available through the Service API.
Authorizations
Every request authenticates with an API key: Authorization: Bearer {API_KEY}. App endpoints take an app API key; knowledge endpoints take a knowledge base API key (Get Started).
Keep keys server-side; never embed them in client code. Requests with a missing or invalid key fail with HTTP 401 (unauthorized).
Query Parameters
Keyword to search in logs.
Filter by execution status.
succeeded, failed, stopped Page number.
1 <= x <= 99999Number of items per page.
1 <= x <= 100Filter logs created before this ISO 8601 timestamp.
Filter logs created after this ISO 8601 timestamp.
Filter by end user session ID.
Filter by the creator's account email (e.g., name@example.com).