List Workflow Logs

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

List Workflow Logs

cURL

curl --request GET \
  --url https://{api_base_url}/workflows/logs \
  --header 'Authorization: Bearer <token>'

200

{
  "page": 1,
  "limit": 20,
  "total": 1,
  "has_more": false,
  "data": [
    {
      "id": "b7e2f8a1-3c4d-5e6f-7890-abcdef123456",
      "workflow_run": {
        "id": "fb47b2e6-5e43-4f90-be01-d5c5a088d156",
        "version": "2025-01-16 12:00:00.000000",
        "status": "succeeded",
        "error": null,
        "elapsed_time": 1.23,
        "total_tokens": 150,
        "total_steps": 3,
        "created_at": 1705407629,
        "finished_at": 1705407630,
        "exceptions_count": 0,
        "triggered_from": "app"
      },
      "created_from": "service-api",
      "created_by_role": "end_user",
      "created_by_account": null,
      "created_by_end_user": {
        "id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
        "type": "service_api",
        "is_anonymous": false,
        "session_id": "user_workflow_123"
      },
      "created_at": 1705407629
    }
  ]
}

Authorizations

Authorization · string · header · required

API Key authentication. For all API requests, include your API Key in the Authorization HTTP Header, prefixed with Bearer. Example: Authorization: Bearer {API_KEY}. Strongly recommend storing your API Key on the server-side, not shared or stored on the client-side, to avoid possible API-Key leakage that can lead to serious consequences.

Query Parameters

keyword · string

Keyword to search in logs.

status · enum<string>

Filter by execution status.

Available options: succeeded, failed, stopped

page · integer · default: 1

Page number for pagination.

Required range: 1 <= x <= 99999

limit · integer · default: 20

Number of items per page.

Required range: 1 <= x <= 100

created_at__before · string<date-time>

Filter logs created before this ISO 8601 timestamp.

created_at__after · string<date-time>

Filter logs created after this ISO 8601 timestamp.

created_by_end_user_session_id · string

Filter by end user session ID.

created_by_account · string

Filter by account ID.

Response

200 - application/json

Successfully retrieved workflow logs.

page · integer

Current page number.

limit · integer

Number of items per page.

total · integer

Total number of log entries.

has_more · boolean

Whether more pages are available.

data · object[]

List of workflow log entries.

Show child attributes