WAwarp
FactoriesMetrics

Get the factory's run counts grouped by a dimension

Changed on

The factory's run counts over a UTC date range, grouped by one dimension. Pass group_by_period to additionally receive per-period series aligned to period_list.

get/factory/{uid}/metrics/run-breakdown

Request

  • Base URL
    https://app.warp.dev/api/v1
  • Auth
    HTTP bearer

Path parameters

uidstring required

The public UID of the factory.

Query parameters

group_by'agent_type' | 'status' | 'source' | 'root_vs_subrun' | 'model' | 'harness' required

Grouping dimension for the run-breakdown metric. source counts top-level runs only; every other dimension counts subruns individually.

The dimension to group run counts by.

start_datestring date-time

Inclusive RFC3339 range start (UTC). Defaults to end_date minus 30 days.

end_datestring date-time

Exclusive RFC3339 range end (UTC). Defaults to now.

group_by_period'day' | 'week' | 'month'

Binning granularity for factory metrics series. Weeks start on Sunday (UTC), consistent with existing Warp analytics.

Optional binning granularity; when omitted, the response contains aggregates only. Binned requests are capped at 365 periods.

Response

Grouped run counts for the requested range

as_ofstring date-time required

The time the data is current as of. Data can lag live activity by a few minutes.

team_uidstring required

Public UID of the team that owns the factory.

factory_uidstring required

Public UID of the factory the response is scoped to.

group_by'agent_type' | 'status' | 'source' | 'root_vs_subrun' | 'model' | 'harness' required

Grouping dimension for the run-breakdown metric. source counts top-level runs only; every other dimension counts subruns individually.

group_by_period'day' | 'week' | 'month'

Binning granularity for factory metrics series. Weeks start on Sunday (UTC), consistent with existing Warp analytics.

period_liststring[]

Period labels every series aligns to (dates like 2026-07-01; weeks labeled by their Sunday start date). Present only when group_by_period was requested.

Changes