v1

latestOpenAPI 3.0.12026-07-26152262362.2 KB

Cloud Diagrams

Get diagram cost snapshot

Returns a bounded cost snapshot for the specified diagram layer over a date window. The response composes the diagram's total spend, period-over-period change, top resources by cost (capped at 5), top services by cost (capped at 5), and a trend series (most recent 12 buckets at the requested interval).

get/clouddiagrams/v1/statussheet/{id}/costs

Path parameters

idstring required

Layer ID.

Query parameters

startDatestring date required

Inclusive start of the cost window (ISO date, e.g. 2026-04-01).

endDatestring date required

Inclusive end of the cost window (ISO date, e.g. 2026-04-28).

interval'day' | 'week' | 'month'

Bucket interval for the trend series. Defaults to day when omitted.

Response

OK - Diagram cost snapshot returned.

diagramIdstring required

Diagram (layer) ID this snapshot was computed for.

currencystring required

Currency the cost numbers are reported in (e.g. USD).

totalnumber required

Total cost across the entire diagram for the snapshot window.

trendingPctnumber nullable required

Period-over-period change as a fraction (e.g. 0.142 = +14.2%). null when no prior period of equal length is available for comparison.