API Referenceworkspace-aggregates

Workspace Workflows Stats

Aggregate workflow counts grouped by derived WorkflowListStatus across the workspace.

Authentication

AuthorizationBearer
Clerk JWT token

Headers

X-Workspace-Idstring or nullOptional

Query parameters

fromdatetime or nullOptional

Filter workflows by created_at >= this ISO datetime.

todatetime or nullOptional

Filter workflows by created_at <= this ISO datetime.

Response

Successful Response
dataobject

Workflow counts grouped by derived WorkflowListStatus for a workspace.

Bucket coverage (V1, by design): total >= draft + running + completed + failed + paused. Workflows whose latest run is cancelled map to no bucket because the spec exposes only the 5 WorkflowListStatus values. The UI must use total for the headline count, not the sum of buckets.

paused is always 0 (spec Non-Goal — UI exposes the bucket for forward compatibility).

metaobject

Errors

422
Unprocessable Entity Error