Dify Octri Demo
GET/workflows/logs

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.

8 parameters
keywordstringoptional
Keyword to search in logs.
statusstringoptional
Filter by execution status.
Allowed:succeededfailedstopped
pageintegeroptional
Page number.
Default:1
limitintegeroptional
Number of items per page.
Default:20
created_at__beforestringoptional
Filter logs created before this ISO 8601 timestamp.
created_at__afterstringoptional
Filter logs created after this ISO 8601 timestamp.
created_by_end_user_session_idstringoptional
Filter by end user session ID.
created_by_accountstringoptional
Filter by the creator's account email (e.g., `name@example.com`).

2 status codes
200Successfully retrieved workflow logs.
dataarray<object>optional
List of workflow log entries.
has_morebooleanoptional
Whether more pages are available.
limitintegeroptional
Number of items per page.
pageintegeroptional
Current page number.
totalintegeroptional
Total number of log entries.
400`invalid_param` : A query parameter is invalid, such as a `created_by_account` value matching no account, a malformed `created_at__before` or `created_at__after` timestamp, or an out-of-range `page`, `limit`, or `status` value.

One documented failure

  • invalid_param

    Account not found: name@example.com

    invalid_param

Error handling

A 400 is returned: invalid_param : A query parameter is invalid, such as a created_by_account value matching no account, a malformed created_at__before or created_at__after timestamp, or an out-of-range page, limit, or status value.