Workflow Runs

List Workflow Logs

Changed on

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

Request

  • Base URL
    https://api.dify.ai/v1
  • URL
    https://api.dify.ai/v1/workflows/logs
  • Auth
    HTTP bearer

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.

has_moreboolean

Whether more pages are available.

limitinteger

Number of items per page.

pageinteger

Current page number.

totalinteger

Total number of log entries.

Changes