API Reference

The WarpBuild API is served at https://api.warpbuild.com/api/v1.

Authentication

Create an API key (a wkey-…) with the ci scope from your dashboard, then send it as a Bearer token:

curl -H "Authorization: Bearer wkey-…" \
  "https://api.warpbuild.com/api/v1/reports/billing/ci?start_date=2026-05-01T00:00:00Z&end_date=2026-06-01T00:00:00Z"

The same key works for the per-job billing CSV (?format=csv), daywise costs, and the other endpoints listed in the sidebar.

Stability

Every operation is annotated with an x-stability level and every response carries an X-WarpBuild-API-Stability header. All endpoints are currently alpha - expect breaking changes and pin only to documented behavior.