v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01302395850.8 KB
v2
admin
admin
blocks

Export Block Cost Estimates

Aggregate per-block average credits-per-execution over [start, end].

Capped at ANALYTICS_MAX_DAYS days. Returns only blocks whose current cost type is dynamic (SECOND/ITEMS/COST_USD) — static-cost blocks already charge correctly pre-flight and don't need an estimate override. TOKENS is excluded because compute_token_credits already supplies a per-model floor at pre-flight; a per-block historical mean would lose that granularity.

get/api/admin/blocks/cost-estimates

Query parameters

startstring date-time nullable

ISO timestamp (inclusive)

ISO timestamp (inclusive)

endstring date-time nullable

ISO timestamp (inclusive)

ISO timestamp (inclusive)

min_samplesinteger

Minimum executions per block to include

Minimum executions per block to include

Response

Successful Response

total_rowsinteger required
window_daysinteger required
max_window_daysinteger required
min_samplesinteger required
generated_atstring date-time required
All 302 operations