Skip to main content
POST
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.
intervals
array
required
One entry per 15-minute interval to reserve.
intervals[].startsAt
string
required
Interval start. RFC 3339, UTC, aligned to 15 minutes (:00, :15, :30, :45).
intervals[].endsAt
string
required
Interval end. Must equal startsAt + 15 minutes. Multi-interval spans are rejected.
intervals[].capacityGb
integer
required
Positive multiple of 4 (the grain is 1 GB-hour = 4 GB × 15 min). Other values are rejected.