Get workflow stats
Changed on<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>
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.
Request
- Base URL: https://app.base44.com
- URL: https://app.base44.com/api/apps/{app_id}/workflows/stats
- Auth: HTTP bearer
Path parameters
ID of the app whose workflows you want to work with.
Query parameters
Start of the window, as an ISO 8601 datetime. Defaults to 24 hours ago.
End of the window, as an ISO 8601 datetime. Defaults to now.
Filter to workflows or hooks. Omit to include both.
Response
One row per workflow that ran in the window.
Example response
[
{
"workflow_id": "68b1c0d4e7b91d003c45a1f2",
"total": 48,
"completed": 44,
"failed": 3,
"cancelled": 1,
"avg_duration_ms": 1840.5,
"last_run_at": "2026-08-25T09:12:44Z",
"last_run_status": "completed"
}
]Changes
- breaking
the
queryrequest parameterexecution_productwas restricted to a list of enum values - breaking
queryrequest parametersincelist-of-types was narrowed by removing typesnull - breaking
queryrequest parameteruntillist-of-types was narrowed by removing typesnull - info
added the new enum value
hooksto thequeryrequest parameterexecution_product - info
added the new enum value
workflowsto thequeryrequest parameterexecution_product - info
for the
queryrequest parameterexecution_product, the type was generalized from no type tostring - info
for the
queryrequest parametersince, the type was generalized from no type tostring - info
for the
queryrequest parameteruntil, the type was generalized from no type tostring
- breaking
- info
added the new optional
queryrequest parameterexecution_product - info
added the non-success response with the status
- info