WAwarp
FactoriesMetrics

Get the factory's PR cost distribution grouped by PR size

Changed on

The mean per-PR attributed cost of the factory's PRs first seen in a UTC date range, grouped by PR size. Pass group_by_period to additionally receive per-period mean series aligned to period_list.

get/factory/{uid}/costs/per-pr/by-size

Request

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

Path parameters

uidstring required

The public UID of the factory.

Query parameters

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

Cost-by-size distribution 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_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