← API reference
Query / workflows

workflowRunStats

Aggregate a workflow's runs over a time window: totals by status, duration percentiles, time buckets and per-node outcomes. Requires workflow:list permission.

Arguments

workflowIdWorkflowID!

Workflow whose runs are aggregated

sinceISO8601!

Start of the window (inclusive), by run start time

untilISO8601

End of the window (exclusive); defaults to now

bucketMinutesInt

Bucket size in minutes, clamped to 5–1440. A window needing more than 500 buckets is rejected.

Default: 60

Returns WorkflowRunStats!

Scalar fields at a glance

totalInt!
medianDurationMsInt
p95DurationMsInt
↗ View the complete WorkflowRunStats type

Explore in a view

Workflow Authoring
View exact SDL
"""
Aggregate a workflow's runs over a time window: totals by status, duration percentiles, time buckets and per-node outcomes. Requires workflow:list permission.
"""
workflowRunStats(
  """Workflow whose runs are aggregated"""
  workflowId: WorkflowID!
  """Start of the window (inclusive), by run start time"""
  since: ISO8601!
  """End of the window (exclusive); defaults to now"""
  until: ISO8601
  """
  Bucket size in minutes, clamped to 5–1440. A window needing more than 500 buckets is rejected.
  """
  bucketMinutes: Int = 60
): WorkflowRunStats! @topic(names: ["workflows"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.