Returns one cost value in USD per agent for each time bucket in the window. group chooses how calls are combined: TOTAL sums their cost; MEAN, MEDIAN, MAXIMUM and MINIMUM give the cost of a single call. For one value per agent over the whole window, use GET /v2/api/sources/metrics/ai/cost-metric-by-agents.

Bucket size by period: HOUR 5 minutes, EIGHT_HOURS 30 minutes, TWENTY_FOUR_HOURS 2 hours, SEVEN_DAYS 12 hours, THIRTY_DAYS 1 day, NINETY_DAYS 1 week, SIX_MONTHS and TWELVE_MONTHS 1 calendar month. Buckets are cut in UTC. Monthly buckets start at midnight UTC on the first of each month; shorter buckets start at the beginning of the window, which is the time of the request minus the period. With a custom startDate and endDate the range is split into 10 equal buckets, the first starting at startDate and the last ending at endDate. Bucket lengths are whole seconds and the last bucket also takes the remainder; a range shorter than 10 seconds is one bucket. Buckets are listed oldest first.