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

List Workflow Logs

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{api_base_url}/workflows/logs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{api_base_url}/workflows/logs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{api_base_url}/workflows/logs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{api_base_url}/workflows/logs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

{
  "code": "invalid_param",
  "message": "Account not found: name@example.com",
  "status": 400
}

Authorizations

Authorization

string

header

required

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

string

Keyword to search in logs.

status

enum<string>

Filter by execution status.

Available options:

succeeded,

failed,

stopped

page

integer

default:1

Page number.

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 the creator's account email (e.g., name@example.com).

Response

Successfully retrieved workflow logs.

data

object[]

List of workflow log entries.

Show child attributes

has_more

boolean

Whether more pages are available.

limit

integer

Number of items per page.

page

integer

Current page number.

total

integer

Total number of log entries.

Last modified on September 9, 2026

List Workflow Logs

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{api_base_url}/workflows/logs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{api_base_url}/workflows/logs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{api_base_url}/workflows/logs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{api_base_url}/workflows/logs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

{
  "code": "invalid_param",
  "message": "Account not found: name@example.com",
  "status": 400
}

Guides

App APIs

Knowledge APIs

List Workflow Logs

Authorizations

Query Parameters

Response