Get workflow stats

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

Counts each workflow’s runs over a time window, for a health view.

Set execution_product to workflows or hooks to filter the results. Omit it to include both. A hook that denies an action still completed successfully; failed runs indicate execution errors.

One row per workflow that ran in the window, with how many runs finished, failed, or were cancelled, and how long they took on average. A workflow with no runs in the window does not appear.

The window can span at most 30 days. Ask for a longer one and the call still succeeds, but since is moved forward so the window ends at until and covers the 30 days before it, and nothing in the response says that happened. Set since and until to choose your own window, up to that cap. Leave both out for the last 24 hours.

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

Get workflow stats

cURL

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

200

[
  {
    "workflow_id": "68b1c0d4e7b91d003c45a1f2",
    "total": 48,
    "completed": 44,
    "failed": 3,
    "cancelled": 1,
    "avg_duration_ms": 1840.5,
    "last_run_status": "completed",
    "last_run_at": "2026-08-25T09:12:44Z"
  }
]

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

since · string

Start of the window, as an ISO 8601 datetime. Defaults to 24 hours ago.

until · string

End of the window, as an ISO 8601 datetime. Defaults to now.

execution_product · enum<string>

Filter to workflows or hooks. Omit to include both.

Available options: workflows, hooks

Response

200

application/json

One row per workflow that ran in the window.

workflow_id · string · required

ID of the workflow these counts belong to.

Example:

"68b1c0d4e7b91d003c45a1f2"

total · integer · required

Runs that started in the window.

Example:

48

completed · integer · required

Runs that finished successfully.

Example:

44

failed · integer · required

Runs that ended in an error.

Example:

3

cancelled · integer · required

Runs that were cancelled before finishing.

Example:

1

avg_duration_ms · number · required

Mean duration of the runs in the window, in milliseconds, including time spent in wait tasks.

Example:

1840.5

last_run_status · string · required

Status of that most recent run. Empty when no run happened in the window.

Example:

"completed"

last_run_at · string | null

When the most recent run in the window started, or null when none ran.

Example:

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