Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Create Reservation

Commit capacity across one or more 15-minute UTC intervals in a single atomic write. The result is one reservation event with a server-generated reservationId covering all intervals in the request. See Reserving capacity for the full write contract.
Send an Idempotency-Key header so retries return the original result. Same key with a different body returns idempotency_key_conflict.
Reservations are non-refundable — there is no cancellation, modification, or transfer.
body intervalsarrayrequired
One entry per 15-minute interval to reserve.
body intervals[].startsAtstringrequired
Interval start. RFC 3339, UTC, aligned to 15 minutes (:00, :15, :30, :45).
body intervals[].endsAtstringrequired
Interval end. Must equal startsAt + 15 minutes. Multi-interval spans are rejected.
body intervals[].capacityGbintegerrequired
Positive multiple of 4 (the grain is 1 GB-hour = 4 GB × 15 min). Other values are rejected.
Response example
{
  "reservationId": "9f67b8f7-7b91-4d2d-b1cb-19d0d0a14562",
  "createdAt": "2026-04-28T18:00:05Z",
  "intervals": [
    {
      "startsAt": "2026-04-29T02:00:00Z",
      "endsAt":   "2026-04-29T02:15:00Z",
      "capacityGb": 16
    },
    {
      "startsAt": "2026-04-29T02:15:00Z",
      "endsAt":   "2026-04-29T02:30:00Z",
      "capacityGb": 16
    }
  ]
}