List workflow runs for an app

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/workflows/runs \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/workflows/runs', 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://app.base44.com/api/apps/{app_id}/workflows/runs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$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://app.base44.com/api/apps/{app_id}/workflows/runs"

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

	req.Header.Add("api_key", "<api-key>")

	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://app.base44.com/api/apps/{app_id}/workflows/runs")

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

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

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

[
  {
    "run_id": "0195f2a1-4c3e-7b21-9f0d-2a5c8e1b4d77",
    "workflow_id": "68b1c0d4e7b91d003c45a1f2",
    "status": "completed",
    "workflow_name": "Email me new signups",
    "trigger_type": "scheduled",
    "started_at": "2026-08-25T09:12:44Z",
    "completed_at": "2026-08-25T09:12:46Z",
    "duration_ms": 1840,
    "steps_count": 3,
    "error_message": "The email step failed because the recipient address was missing.",
    "is_test_run": false,
    "credits_consumed": 0.5,
    "status_reason": ""
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Runs

List workflow runs for an app

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Lists runs across every workflow on the app, newest first.

Use status to keep only runs in one state, and since to keep only runs that started after a moment in time. Page with limit and offset.

Each row names its workflow, so this is the endpoint for an activity feed. For one workflow’s history use List runs for a workflow.

This endpoint is limited to 60 requests per minute.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

GET

api

apps

{app_id}

workflows

runs

List workflow runs for an app

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/workflows/runs \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/workflows/runs', 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://app.base44.com/api/apps/{app_id}/workflows/runs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$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://app.base44.com/api/apps/{app_id}/workflows/runs"

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

	req.Header.Add("api_key", "<api-key>")

	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://app.base44.com/api/apps/{app_id}/workflows/runs")

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

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

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

[
  {
    "run_id": "0195f2a1-4c3e-7b21-9f0d-2a5c8e1b4d77",
    "workflow_id": "68b1c0d4e7b91d003c45a1f2",
    "status": "completed",
    "workflow_name": "Email me new signups",
    "trigger_type": "scheduled",
    "started_at": "2026-08-25T09:12:44Z",
    "completed_at": "2026-08-25T09:12:46Z",
    "duration_ms": 1840,
    "steps_count": 3,
    "error_message": "The email step failed because the recipient address was missing.",
    "is_test_run": false,
    "credits_consumed": 0.5,
    "status_reason": ""
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose workflows you want to work with.

Query Parameters

limit

integer

default:30

Most runs to return.

Required range: 1 <= x <= 200

offset

integer

default:0

How many runs to skip, for paging.

Required range: x >= 0

status

string | null

Keep only runs in this state, for example failed.

since

string | null

Keep only runs that started at or after this ISO 8601 datetime.

Response

Runs across the app's workflows, newest first.

run_id

string

required

ID of the run.

Example:

"0195f2a1-4c3e-7b21-9f0d-2a5c8e1b4d77"

workflow_id

string

required

ID of the workflow that ran.

Example:

"68b1c0d4e7b91d003c45a1f2"

status

string

required

How the run is going: running, completed, failed, or cancelled.

Example:

"completed"

workflow_name

string

default:""

Name of that workflow at the time of the run.

Example:

"Email me new signups"

trigger_type

string

default:""

What started the run, for example scheduled or entity_created.

Example:

"scheduled"

started_at

string | null

When the run started, as an ISO 8601 timestamp.

Example:

"2026-08-25T09:12:44Z"

completed_at

string | null

When the run finished. null while it is still running.

Example:

"2026-08-25T09:12:46Z"

duration_ms

integer

default:0

How long the run took, in milliseconds. 0 while it is still running.

Example:

1840

steps_count

integer

default:0

Steps the run executed.

Example:

3

error_message

string | null

Why the run failed. null when it did not fail.

Example:

"The email step failed because the recipient address was missing."

is_test_run

boolean

default:false

true when the run was started by hand through Run a workflow now, rather than by its trigger.

Example:

false

credits_consumed

number

default:0

Credits the run used.

Example:

0.5

status_reason

string

default:""

Why the run failed or was cancelled. Empty on runs that finished successfully.

Example:

""

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

List workflow runs for an app

Authorizations

Path Parameters

Query Parameters

Response