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.

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

Set status to return only runs in one state. Set since to return only runs that started after a moment in time.

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

GET /api/apps/{app_id}/workflows/runs

List workflow runs for an app

cURL

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

200

[
  {
    "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": ""
  }
]

Authorizations

Authorization · string · header · required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

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

Keep only runs in this state, for example failed.

since · string

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

Response

200

application/json

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. See Workflow status for how this compares to the workflow's own status.

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: scheduled, entity, connector, in_app_agent, app_user_auth, app_publish, app_payment, webhook, or goal_file. See Triggers for what each one fires on. A run started through Run a workflow now with no payload to replay reports manual instead.

Example:

"scheduled"

started_at · string | null

When the run started, as an ISO 8601 UTC timestamp.

Example:

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

completed_at · string | null

When the run finished, as an ISO 8601 UTC timestamp. This is null while it is still running.

Example:

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

duration_ms · integer · default: 0

How long the run took, in milliseconds. This is 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. This is null when it did not fail.

Example:

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

is_test_run · boolean · default: false

This is 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:

""