WAwarp
FactoriesMetrics

Get factory spend grouped by a dimension

Changed on

The factory's spend over a UTC date range, grouped by source, user, agent, or model. groups lists every entity with nonzero spend in the range (uncapped); UNKNOWN sorts last. Pass group_by_period to additionally receive per-period series aligned to period_list.

get/factory/{uid}/costs/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'source' | 'user' | 'agent' | 'model' required

Grouping dimension for the cost-breakdown metric. source and user roll each run tree's cost to the root run; agent and model keep each run's own cost.

The dimension to group spend 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 spend 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'source' | 'user' | 'agent' | 'model' required

Grouping dimension for the cost-breakdown metric. source and user roll each run tree's cost to the root run; agent and model keep each run's own cost.

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